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.
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.
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. Hi-res, video, engine atlases, normal maps and the live runtime bundle also need a plan.
build_effect (1 build Basic, Pro 10): Our agent builds an effect from a description. model "basic" (default) or "pro", a much stronger model for complex effects.

Home | Free effects | Studio | AI agent | Pricing