MCP Tools Reference
Every ParticleFX Studio MCP tool: parameters, costs, example calls and replies, and errors. Create, edit, preview and export particle effects from an AI app.
- list_presets (Free): Search the effect library.
- get_reference (Free): Parameter, edit-language and craft guides.
- search_sprites (Free): Find bundled sprites.
- create_effect (1 build per new effect): New effect from a library preset or blank, saved to your account.
- list_effects (Free): Your saved effects.
- get_effect (Free): Read an effect.
- edit_effect (Free after first write): Apply edit ops, draw SVG sprites. Free on an effect you've made over MCP; the first edit of a website effect costs 1 build.
- undo_edit (Free after first write): Revert edits. Free on an effect you've made over MCP; the first edit of a website effect costs 1 build.
- duplicate_effect (1 build per new effect): Copy an effect; the copy is a new effect.
- suggest_variations (One preview): A contact sheet of new takes on an effect (hue, motion, shape), counted like one render_preview.
- apply_variation (Free after first write): Keep one variation, as one edit. Free on an effect you've made over MCP; the first edit of a website effect costs 1 build.
- tweak_effect (Free after first write): Quick tweaks of the whole effect: size, amount, speed, recolour, glow, loop or once. Free on an effect you've made over MCP; the first edit of a website effect costs 1 build.
- copy_layers (Free after first write): Copy layers, a group or a module from one effect or a library preset into another effect, with fresh ids. Free on an effect you've made over MCP; the first edit of a website effect costs 1 build.
- delete_effect (Free): Remove an effect.
- render_preview (20 a day free, then 1 build per 4): Labelled contact sheet of the loop for checking your work, frames up to 256 px. Up to 200 a day.
- analyze_effect (Free): Loop check, particle counts, mistakes.
- open_in_studio (Free): Link that opens the effect in the studio, plus a share link anyone can open as a copy (not FX pack effects).
- import_effect (1 build per new effect): Import a .pfx.json document.
- upload_sprite (Free after first write): Add your own character or sprite to an effect (PNG, WebP or GIF, up to 2 MB and 2048 px) and optionally swap it in as the hero of a Sprite FX effect. Uploading is free; it is an edit of that effect. 60 uploads a day.
- export_effect (1 build): GIF, WebP, APNG, PNG frames, PNG grid sheet, Roblox flipbook PNG. Hi-res, video, engine atlases, normal maps, the Roblox model and the live runtime bundle also need a plan.
- build_effect (5 builds, Pro 10): A fallback: our own agent builds an effect from a description, on our model. Use it only when the user asks for it or the caller cannot use the tools; the tools above are the main route and cost far less. model "basic" (default) or "pro".
- Docs: MCP Server, API and Studio Tools
- MCP Server: Particle Effects from Claude, Cursor and ChatGPT
- MCP Tools Reference
- Use Your Own Sprite with the MCP Server
- API Keys, Rate Limits and Billing
- Studio Tools: History, Check, Find, Copy and Paste, Export for
Home | Free effects | Studio | AI agent | Pricing