# Particlr MCP

> Particlr MCP is an open-source MCP server for design and media. Let coding agents build, simulate and render particlr particle effects without a browser. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI
- **Website:** https://particlr.com
- **Repository:** https://github.com/brac/particlr-mcp
- **MCP Registry name:** io.github.brac/particlr-mcp
- **Categories:** design and media, games and play, developer tools
- **Listing updated:** 2026-11-14

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

```sh
claude mcp add particlr-mcp -- npx -y @particlr/mcp
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "particlr-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@particlr/mcp"
      ]
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "particlr-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@particlr/mcp"
      ]
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "particlr-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@particlr/mcp"
      ]
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "particlr-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@particlr/mcp"
      ]
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "particlr-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@particlr/mcp"
      ]
    }
  }
}
```

## Tools

- `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.

## 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

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [HyperFrames by HeyGen](https://ai-powered.com/mcp/hyperframes-by-heygen): HyperFrames by HeyGen is a freemium MCP server for design and media.
- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [GitHub](https://ai-powered.com/mcp/github-2): GitHub is an open-source MCP server for developer tools.
- [Serena MCP: the IDE for your agent](https://ai-powered.com/mcp/serena-mcp-the-ide-for-your-agent): Serena MCP: the IDE for your agent is an open-source MCP server for developer tools.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.
- [ffmpeg-skill](https://ai-powered.com/mcp/ffmpeg-skill): ffmpeg-skill is an open-source MCP server for design and media.
- [Ouroboros](https://ai-powered.com/mcp/ouroboros): Ouroboros is an open-source MCP server for developer tools.

---
Source: https://ai-powered.com/mcp/particlr-mcp
