Skip to content
MCP server

Particlr MCP

Let coding agents build, simulate and render particlr particle effects without a browser

Runs locallyStatus and history
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/mcp

Add to claude_desktop_config.json

{
  "mcpServers": {
    "particlr-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@particlr/mcp"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "particlr-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@particlr/mcp"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

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

  1. REA

    MCP server

    CLI and MCP server that lets coding agents reverse engineer apps and binaries

    Runs locally
    • Open source
    • 464K GitHub stars
    • Developer tools
  2. Hosted MCP connector for creating and rendering videos from HTML through AI chat

    • Remote
    • Freemium
    • 85.3K GitHub stars
    • Design and media
  3. Codebase Memory

    MCP server

    Local MCP server that builds a code knowledge graph for AI coding agents

    Runs locally
    • Open source
    • 48.7K GitHub stars
    • Knowledge and memory
  4. GitHub

    MCP server

    Official MCP server connecting AI assistants to GitHub repos, issues and workflows

    Not checked yet
    • Remote
    • Open source
    • 34.5K GitHub stars
    • Developer tools
  5. MCP toolkit giving coding agents symbol-level code retrieval and editing

    Runs locally
    • Open source
    • 31.5K GitHub stars
    • Developer tools
  6. XERJ

    MCP server

    Local search engine for AI agents with cited answers over your code and docs

    Runs locally
    • Open source
    • 19.2K GitHub stars
    • Knowledge and memory