Server data from the Official MCP Registry
Agents author particlr .prt particle effects headlessly: validate, simulate, render to PNG, patch.
About
Agents author particlr .prt particle effects headlessly: validate, simulate, render to PNG, patch.
Security Report
This is a deterministic headless particle-effect authoring server with read-only feedback tools and an in-process session store, and no malicious patterns, hardcoded secrets, shell execution, or data exfiltration appear in the reviewed code. The only notable concerns are a truncated handles.ts file that could not be fully reviewed and minor code-quality observations, which do not significantly lower the score. Permissions (file read of bundled assets, local stdio transport, in-memory state) match the stated purpose. Supply chain analysis found 3 known vulnerabilities in dependencies (1 critical, 1 high severity). Package verification found 1 issue.
10 files analyzed · 8 issues found
Security scores are indicators to help you make informed decisions, not guarantees. Always review permissions before connecting any MCP server.
Permissions Required
This plugin requests these system permissions. Most are normal for its category.
How to Install
Add this to your MCP configuration file:
{
"mcpServers": {
"mcp": {
"command": "npx",
"args": [
"-y",
"@particlr/mcp@0.3.1"
]
}
}
}Some servers take additional arguments. See the repository for details.
Documentation
View on GitHubFrom the project's GitHub README.
@particlr/mcp
Source: https://github.com/brac/particlr-mcp (MIT).
An MCP server that lets coding agents author particlr
.prt particle effects headlessly, with a real feedback loop instead of blind
JSON generation: validate against the actual parse/migrate/validate pipeline,
simulate deterministically in Node, render frames to PNG with a CPU
rasterizer, and iterate by patching — no browser, no GPU, no flakiness.
Everything is deterministic: the same document, seed, and dt sequence produce
the same simulation state and the same pixels, so a diff between two renders
is a real diff. Effects authored here play back byte-for-byte in
@particlr/runtime
(PixiJS v8/v7) and open in the particlr editor.
Setup
Requires Node >= 20. For Claude Code, add to .mcp.json (or for any MCP
client, the equivalent stdio server config):
{
"mcpServers": {
"particlr": {
"command": "npx",
"args": ["-y", "@particlr/mcp"]
}
}
}
The loop
An agent authoring an effect works this cycle:
get_reference("authoring-guide")— how to make a.prtlook good: units, layer recipes, blend idioms, common mistakes."format-spec"and"schema"are the normative references.list_presets/get_preset— 71 CC0 effects (explosions, fire, smoke, shields, trails, weather…) as a few-shot corpus. Pull the closest one and mutate it.open_effect— validate and store the doc under a session handle.patch_effect— iterate by sending only RFC 6902 diffs (replace/add/remove), all-or-nothing with rollback on any error.simulate_effect— the cheap loop: per-layer live counts over time, peak vs capacity, spatial bounds, completion time, and a reproducible statehash.render_effect— see it: a 16-frame auto-framed contact sheet PNG by default, or individual frames at chosen times.overrunSecondsrenders past the duration to check loop seams.get_effect— pull the canonical.prttext for delivery.
Tools
| Tool | What it does |
|---|---|
validate_effect | Parse → migrate → validate; canonical doc or path-anchored errors |
simulate_effect | Deterministic headless sim: counts, bounds, completion, statehash |
render_effect | CPU-rasterize to PNG frame(s) or a contact sheet |
open_effect | Store a doc under a session handle for iteration |
patch_effect | Apply RFC 6902 ops to a stored doc, re-validate, rollback on failure |
get_effect | Fetch the canonical stored .prt text |
list_presets / get_preset | The shipped preset corpus |
get_reference | Authoring guide, format spec, or JSON Schema, inline |
What the renderer is (and isn't)
render_effect is a deterministic software rasterizer built for agent
iteration: all builtin and embedded-PNG textures, all five blend modes,
flipbooks, stretch/velocity-align, per-particle and connect-ribbon trails,
and layer draw order. It is structurally faithful to the GPU preview, not
pixel-identical to it. Two things it does not show: the dissolve module is
not rasterized, and the emitter never moves headlessly, so world-space trails
that depend on emitter motion read as local. Judge those in the
editor — effects round-trip losslessly.
Session handles live only for the server process; export with get_effect
before disconnecting.
License
MIT. See LICENSE. The source is public at https://github.com/brac/particlr-mcp.
Reviews
No reviews yet
Be the first to review this server!
More Developer Tools MCP Servers
Rea
Freeby Morluto · Developer Tools
Reverse engineer anything from your terminal or agent with one CLI and MCP server.
Paperclip
Freeby Paperclipai · Developer Tools
Trending hip-hop artist momentum scores across four cultural dimensions.
Scrapling
Freeby D4Vinci · Developer Tools
Web scraping with stealth HTTP, real browsers, and Cloudflare bypass. CSS selectors supported.
Git
Freeby Modelcontextprotocol · Developer Tools
Read, search, and manipulate Git repositories programmatically
Toleno
Freeby Toleno · Developer Tools
Toleno Network MCP Server — Manage your Toleno mining account with Claude AI using natural language.
MCP Marketplace
Freeby mcp-marketplace · Developer Tools
Search and install MCP servers from inside your AI client.
