Particlr MCP
Let coding agents build, simulate and render particlr particle effects without a browser
- Pricing
- Open source
- Platforms
- CLI
- Runs
- Locally
- Version
- 0.3.1
- Listing updated
- 3 days ago
About Particlr MCP
Particlr MCP is an open-source MCP server for design and media. It runs locally on your machine and is started by your AI client.
Particle effects are usually tuned by eye, which is hard for an agent. This server gives it a feedback loop: validate a .prt document with the same parser the runtime uses, simulate it deterministically in Node, render frames to PNG with a CPU rasterizer, and fix problems by sending small RFC 6902 patches that roll back on error.
It ships 71 CC0 presets as starting points and three reference documents: an authoring guide, a format spec and a JSON Schema. Output plays back in the free MIT runtime for PixiJS, Three.js or Phaser 4 and opens in the particlr editor. The README notes the headless renderer is close to the GPU preview but does not draw dissolve and the emitter does not move.
The server is MIT and runs over npx with Node 20 or newer. Premium editor modules cost a one-time key.
Install
Run in a terminal
claude mcp add particlr-mcp -- npx -y @particlr/mcpAdd to claude_desktop_config.json
{
"mcpServers": {
"particlr-mcp": {
"command": "npx",
"args": [
"-y",
"@particlr/mcp"
]
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"particlr-mcp": {
"command": "npx",
"args": [
"-y",
"@particlr/mcp"
]
}
}
}Add to .vscode/mcp.json
{
"servers": {
"particlr-mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@particlr/mcp"
]
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"particlr-mcp": {
"command": "npx",
"args": [
"-y",
"@particlr/mcp"
]
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"particlr-mcp": {
"command": "npx",
"args": [
"-y",
"@particlr/mcp"
]
}
}
}Tools this server provides (9)
Taken from the project documentation; the running server may differ.
- validate_effect
- Parse, migrate and validate; returns the canonical doc or path-anchored errors.
- simulate_effect
- Deterministic headless simulation: counts, bounds, completion, state hash.
- render_effect
- Rasterizes to PNG frames or a contact sheet.
- open_effect
- Stores a document under a session handle for iteration.
- patch_effect
- Applies RFC 6902 operations, re-validates and rolls back on failure.
- get_effect
- Returns the canonical .prt text.
- get_reference
- Returns the authoring guide, format spec or schema.
- list_presets
- Lists the 71 CC0 presets.
- get_preset
- Returns one preset.
What it does
- Validate
- Checks a document against the real parse, migrate and validate pipeline.
- Deterministic simulation
- Reports counts, bounds, completion time and a reproducible state hash.
- PNG rendering
- Draws a 16-frame contact sheet or chosen frames without a GPU.
- Patch with rollback
- Applies diffs all-or-nothing.
- 71 CC0 presets
- Explosions, fire, smoke, shields and weather to adapt.
Good for
- Create a muzzle flash or explosion for a web game
- Adjust an existing preset by prompt
- Check an effect loops cleanly
- Review a render before opening the editor
Pricing
Open source
MIT server and runtime; premium editor key $10 one-time (later $20)
Prices change. Check particlr.com before you buy.
Particlr MCP FAQ
What do I need to run it?
Node 20 or newer; the README gives an npx config.
Does it need a GPU?
No. Rendering uses a CPU rasterizer.
What costs money?
The editor is free; the premium modules are one key, $10 one-time during the beta, later $20.
Is Particlr MCP free?
Yes. Particlr MCP is open source, so you can use and self-host it for free.
How do I add Particlr MCP to Claude Code?
Run this command in your terminal: claude mcp add particlr-mcp -- npx -y @particlr/mcp
What are the best alternatives to Particlr MCP?
The closest alternatives to Particlr MCP are REA, HyperFrames by HeyGen, Codebase Memory, GitHub and Serena MCP: the IDE for your agent.
Alternatives to Particlr MCP

REA
MCP serverCLI and MCP server that lets coding agents reverse engineer apps and binaries
Runs locally- Open source
- 464K GitHub stars
- Developer tools

HyperFrames by HeyGen
MCP serverHosted MCP connector for creating and rendering videos from HTML through AI chat
- Remote
- Freemium
- 85.3K GitHub stars
- Design and media

Codebase Memory
MCP serverLocal MCP server that builds a code knowledge graph for AI coding agents
Runs locally- Open source
- 48.7K GitHub stars
- Knowledge and memory

GitHub
MCP serverOfficial MCP server connecting AI assistants to GitHub repos, issues and workflows
Not checked yet- Remote
- Open source
- 34.5K GitHub stars
- Developer tools

Serena MCP: the IDE for your agent
MCP serverMCP toolkit giving coding agents symbol-level code retrieval and editing
Runs locally- Open source
- 31.5K GitHub stars
- Developer tools

XERJ
MCP serverLocal search engine for AI agents with cited answers over your code and docs
Runs locally- Open source
- 19.2K GitHub stars
- Knowledge and memory