io.github.brac/particlr-mcp

NPM · @PARTICLR/MCP · SCANNED AUG 3

Agents author particlr .prt particle effects headlessly: validate, simulate, render to PNG, patch.

Available components

62 62 Trust /100

Trust breakdown (6 categories)

How this component scores in each security and reliability category. Every signal is checked automatically from public evidence about the published package, including repeated runs of it in an isolated sandbox, and we only credit what we can confirm. How we score →

Supply Chain Security87

No malware found by supply-chain analysis.Pass
Only part of the dependency tree could be resolved (96 of 100), so this covers what we could see, not the whole tree.Partial
No install/post-install scripts declared.Pass
Only part of the dependency tree could be resolved (96 of 100), so this covers what we could see, not the whole tree. View diagnostics → Partial

Provenance & Transparency19

Repository check failed: no source repository is declared. See how to fix → View diagnostics → Fail
Provenance check failed: no build-provenance attestation is published. See how to fix → View diagnostics → Fail
Clear OSI-approved license (MIT).Pass
Actively maintained (last published 3 days ago).Pass
Security-disclosure policy not yet verified: we couldn't inspect the source repository.Unverified

Schema Quality & AI Usability84

100% of prompts and resources have a non-trivial description (not blank, and not just the item's name).Pass
AI-judged instruction clarity (excellent).Pass
Context-footprint check failed: tool/resource definitions use about 1404 tokens (~117/item across 12 items; 9 tools + 3 resources), over budget; trim descriptions and params. See how to fix → Fail
Usage-examples check failed: none of the tools include examples. See how to fix → Fail

Stability & Change Management0

Stability not yet verified: not enough scan history yet (needs a 30-day window).Unverified

Tool Coverage100

100% of tools have a non-trivial description (not blank, and not just the tool's name).Pass
100% of tool parameters carry a description.Pass
Structured output schemas are declared (100% of tools); any adoption earns full credit.Pass

Capabilities100

Implements a supported MCP spec version (2025-11-25); the latest is 2026-07-28.Pass

Unverified: 1 category

A category scored 0 because we could not verify it: a data source with nothing on this package, evidence we could not reach, or a check we could not run. We only credit what we can confirm.

Install

Add this component to your MCP client. Where a client-specific snippet is available, pick your client below and copy it straight into your config; otherwise use the connection detail shown.

npm · @particlr/mcp

Claude Codex opencode OpenClaw Hermes Other

# add to Claude Code

claude mcp add brac-particlr-mcp -- npx -y @particlr/mcp

# add to Codex CLI

codex mcp add brac-particlr-mcp -- npx -y @particlr/mcp

// opencode.json

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "brac-particlr-mcp": {
      "type": "local",
      "command": [
        "npx",
        "-y",
        "@particlr/mcp"
      ],
      "enabled": true
    }
  }
}

# add to OpenClaw

openclaw mcp add brac-particlr-mcp --command npx --arg -y --arg @particlr/mcp

# ~/.hermes/config.yaml

mcp_servers:
  brac-particlr-mcp:
    command: "npx"
    args: ["-y", "@particlr/mcp"]

// mcp.json

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

Changelog

Every change we have recorded for this component, newest first. Security-relevant changes are always shown. ▲ marks a change for the better, ▼ a change for the worse; unmarked changes are neutral.

3 Aug 26 +26
- Provenance: unverified → fail ▼ security
- Install scripts: unverified → pass ▲ security
- Known CVEs: unverified → partial ▲ security
- Stability: Stability not yet verified: not enough scan history yet (needs a 30-day window). security
- Schema quality: unverified → excellent ▲ functional
- License: unverified → pass ▲ functional
- Dependency health: unverified → partial ▲ functional
- Maintenance: unverified → pass ▲ functional
- MCP protocol: unverified → pass ▲ functional
- Licence: MIT functional
2 Aug 26 +10
- Malware scan: unverified → pass ▲ security
- Stability: Stability not yet verified: we do not have a sandbox capture of the MCP schema this version of the package serves yet. security
- Capabilities: pass → unverified ▼ functional
1 Aug 26 −2
- We updated how we score, so this day's move reflects our rubric, not a change to the server See what changed → functional
30 Jul 26 28

First indexed and scored.

Show 2 earlier entries Hide earlier entries

Diagnostics

Diagnostic detail from the automated scan of this channel: what the scanner observed at each step, so you can see exactly where a check passed or failed. It is informational only and never changes the trust score.

Captured 3 Aug 2026 · Analysed npm/@particlr/[email protected]

Provenance none

Ecosystem: npm · Outcome: none

Dependencies 96 packages

96 packages in the resolved dependency tree · 95 deprecated · 29 stale.

The dependency tree was only partially resolved, so these counts may be incomplete.

MCP tools — 9 exposed · ~1,338 tokens

The tools this component advertises to a client, with an estimated token cost for each. Expand a tool to see its parameters and schema. The per-tool counts are indicative and are not scored directly; the schema's total context footprint is one signal in Schema Quality & AI Usability.

Tool Tokens

get_effect Get Effect ~58

Fetch the canonical stored .prt text for a handle — use this for final delivery/export after iterating. Handles live only for this session (server process); they do not survive a reconnect.

Input Output Examples

Name	Type	Req	Description
handle	string	yes	A handle from open_effect.

Name	Type	Req	Description
doc	string	yes	The canonical stored .prt text — for final delivery/export.
handle	string	yes	—

No examples provided.

get_preset Get Preset ~61

Fetch one shipped preset by name (stem): its raw .prt text plus a parsed summary. Unknown name returns an error listing the valid names.

Input Output Examples

Name	Type	Req	Description
name	string	yes	The preset filename stem (see list_presets), e.g. "explosion".

Name	Type	Req	Description
doc	string	yes	The preset's raw .prt JSON text.
name	string	yes	—
summary	object	yes	—

No examples provided.

get_reference Get Reference ~104

Fetch reference material inline: topic "format-spec" (the .prt format spec, markdown) or "schema" (the JSON Schema for a .prt document).

Input Output Examples

Name	Type	Req	Description
topic	string	yes	"format-spec" = the .prt format spec (markdown); "schema" = the JSON Schema for a .prt document; "authoring-guide" = how to author a .prt that LOOKS good (units, blend/layer/curve/trail recipes, comm…

Name	Type	Req	Description
format	string	yes	—
text	string	yes	—
topic	string	yes	—

No examples provided.

list_presets List Presets ~32

List the shipped .prt presets (name, layer count, schemaVersion) — the few-shot authoring corpus.

Input Output Examples

Input schema present but exposes no named parameters.

Name	Type	Req	Description
presets	array	yes	—

No examples provided.

open_effect Open Effect ~111

Validate a .prt document and store it under a session handle so you can iterate without resending the text. Returns the handle + validate fields (ok, schemaVersion, warnings, errors); pass the handle to patch_effect / validate_effect / simulate_effect / render_effect. Handles live only for this session (server process); they do not survive a reconnect. Capped at 64 per session.

Input Output Examples

Name	Type	Req	Description
doc	string	yes	The .prt document as a JSON string. Validated and stored under a fresh handle.

Name	Type	Req	Description
errors	array	yes	—
handle	string\|null	yes	A session handle ("fx-1", …) to pass as `handle` to patch/validate/simulate/render; null on failure.
migratedFrom	number\|null	yes	The doc's ORIGINAL schemaVersion if it was migrated up, else null.
ok	boolean	yes	—
schemaVersion	number\|null	yes	—
warnings	array	yes	—

No examples provided.

patch_effect Patch Effect ~156

Apply a small list of RFC 6902 ops (replace/add/remove) to a stored effect, then re-validate. Iterate by sending only the diff, not the whole document. Any failure — bad path/index or a post-patch validation error — rolls back: the stored doc is left unchanged and the failing op index is named. Handles live only for this session (server process); they do not survive a reconnect.

Input Output Examples

Name	Type	Req	Description
handle	string	yes	A handle from open_effect.
ops	array	yes	Restricted RFC 6902 ops (replace/add/remove) applied IN ORDER (max 64). Any failure — bad path, bad index, or a post-patch validation error — rolls back: the stored doc is unchanged.

Name	Type	Req	Description
errors	array	yes	—
handle	string\|null	yes	A session handle ("fx-1", …) to pass as `handle` to patch/validate/simulate/render; null on failure.
migratedFrom	number\|null	yes	The doc's ORIGINAL schemaVersion if it was migrated up, else null.
ok	boolean	yes	—
schemaVersion	number\|null	yes	—
warnings	array	yes	—

No examples provided.

render_effect Render Effect ~512

CPU-rasterize a .prt effect to PNG image(s): by default one contact-sheet PNG of 16 frames evenly spaced over [0, completion||duration], auto-framed. All builtin + embedded-PNG textures, all five blend modes, flipbook, stretch/velocity-align/flip, per-particle + connect-ribbon TRAILS, and layer draw order are rendered; DISSOLVE is NOT rasterized (a dissolve doc still renders its sprites). Deterministic: frames snap to the same 1/60 trajectory as simulate_effect. Returns image block(s) + a renderHash, the snapped times, the viewport, and the grid. An invalid doc returns validate-shaped errors.

Input Output Examples

Name	Type	Req	Description
background	string	—	Background: "checker" (default), "transparent", or a hex color (#rgb / #rrggbb / #rrggbbaa).
doc	string	—	The .prt document as a JSON string.
fps	number	—	Frames at 0, 1/fps, 2/fps … up to the range end. Overrides `frames`.
frames	integer	—	Number of evenly-spaced frames over [0, completion\|\|duration]. Default 16; max 64.
handle	string	—	A handle from open_effect — use instead of doc to avoid resending the document.
height	integer	—	Frame height in px. Default 256; cap 1024 longest edge.
layout	string	—	"sheet" (default): one contact-sheet PNG. "separate": one PNG per frame (same caps).
overrunSeconds	number	—	Render past the loop seam: extends the frames/fps time range to duration + overrunSeconds. Looping docs only; ignored (with a warning) otherwise. Explicit `times` already accept any time.
seed	integer	—	Override the doc's authored seed. Default: the doc's seed.
supersample	number	—	Anti-alias by rendering at 2x/4x then downsampling. Default off (crisp, byte-golden).
times	array	—	Explicit render times in seconds (snapped to 1/60 boundaries). Max 64. Overrides frames/fps.
viewport	object	—	Explicit world-space viewport. Auto-framed from a bounds scan (+12% margin) when omitted.
width	integer	—	Frame width in px. Default 256; cap 1024 longest edge.

Name	Type	Req	Description
completionTime	number\|null	yes	—
frameHeight	integer	yes	—
frameWidth	integer	yes	—
grid	—	yes	Contact-sheet grid; null in separate mode.
imageCount	integer	yes	—
layout	string	yes	—
renderHash	string	yes	hex8 over normalizedDoc + seed + snapped times + size + viewport + bg — distinct from the sim statehash.
snappedTimes	array	yes	The actual step-snapped render times (seconds).
viewport	object	yes	—
warnings	array	yes	—

No examples provided.

simulate_effect Simulate Effect ~206

Deterministically step a .prt effect in Node (no rendering) and report per-layer live counts over time, peak vs capacity, spatial bounds, completion, and a statehash plus the exact {seed, dt, steps} to reproduce it. Same seed + dt sequence => identical output. Validates first; an invalid doc returns validate-shaped errors.

Input Output Examples

Name	Type	Req	Description
doc	string	—	The .prt document as a JSON string.
dt	number	—	Fixed timestep. Default 1/60; clamped to (0, 0.05] (the runtime MAX_DT).
duration	number	—	Seconds to simulate. Default 3; capped at 60.
handle	string	—	A handle from open_effect — use instead of doc to avoid resending the document.
sampleInterval	number	—	Seconds between count samples. Default 0.1.
seed	integer	—	Override the doc's authored seed. Default: the doc's seed.

Name	Type	Req	Description
bounds	—	yes	Axis-aligned bounds over every live particle across the run; null if none ever spawned.
completed	boolean	yes	True if the effect reached isDone (one-shots); false for looping/unfinished.
completionTime	number\|null	yes	Seconds at which isDone first held; null if never.
echo	object	yes	The exact inputs used after defaulting/clamping — replay these for an identical statehash.
layers	array	yes	—
statehash	string	yes	hex8 FNV-1a over the final public sim state — reproducible per {seed, dt, steps}.
warnings	array	yes	—

No examples provided.

validate_effect Validate Effect ~98

Validate a .prt document (JSON string) against the real parse -> migrate -> validate pipeline. Returns ok + the canonical normalized doc + schemaVersion (and the pre-migration version), or structured, path-anchored errors worded for you to fix.

Input Output Examples

Name	Type	Req	Description
doc	string	—	The .prt document as a JSON string.
handle	string	—	A handle from open_effect — use instead of doc to avoid resending the document.

Name	Type	Req	Description
errors	array	yes	—
migratedFrom	number\|null	yes	The doc's ORIGINAL schemaVersion if it was migrated up, else null.
normalizedDoc	string\|null	yes	Canonical serializeParticle() output on success (agents iterate on this); null on failure.
ok	boolean	yes	—
schemaVersion	number\|null	yes	The doc's schemaVersion after migration; null when parsing failed.
warnings	array	yes	—

No examples provided.

On this page

Handy links

Scoring key

80+ high trust
60–79 medium
below 60 low

How we score

Score history · last 30 days

30 Jul 3 Aug