Agentic Mermaid
Render, verify, describe, and safely edit Mermaid diagrams through MCP.
| Endpoint | https://agentic-mermaid.dev/mcp (streamable-http) |
|---|---|
| Registry version | 0.4.1 |
| Now | 9 tools · grade D (57) · pin ts_ddd3bea40978825b9bb76ab22ed1b1c6 · protocol 2025-06-18 |
| First / last listed | 2026-10-29 01:57 UTC / 2026-10-29 01:57 UTC |
| Grade over time | 2026-10-29: D (57), 9 tools |
Is this your server? Own a server? ToolFit hosted watch re-checks it every 24 h ($0.25 per 30 days) or 6 h ($0.60) and sends you an HMAC-signed webhook when its tools or grade change: POST https://api.youraitools.co/toolfit/v1/watch. To opt out, see About & opt-out.
Tools: execute describe_sdk render_svg render_ascii render_png verify describe mutate build
execute | Run JavaScript in an isolated sandbox; return a value.
One call composes edits. Submit JavaScript; declaration types are guidance.
No promises, async/await, dynamic import, or type annotations.
Hosted note: execute runs in an on-demand isolate and costs more than the direct
render_svg/render_ascii/render_png/verify/describe tools — prefer those for plain
render/verify calls. For straightforward st params: code*, timeoutMs |
describe_sdk | Return version-matched mutation operations for one diagram family.
Use detail=signatures for the compact op menu or detail=fields (default) for exact
field types, required flags, enum values, defaults, and constraints. Call this
before build, mutate, or execute when the family schema is not already known. params: family*, detail |
render_svg | Render a Mermaid source string to themeable SVG. Returns { ok, svg }.
Layout is deterministic: identical input produces identical geometry. The hosted
boundary forces security:'strict' and embedFontImport:false. params: source*, options |
render_ascii | Render a Mermaid source string to text. Returns { ok, text }.
useAscii true → plain ASCII (+,-,|); false/absent → Unicode box drawing (┌,─,│).
targetWidth sets a hard terminal display-cell bound; impossible bounds return a typed error. params: source*, useAscii, targetWidth, options |
render_png | Rasterize a Mermaid source string to PNG. Returns { ok, png_base64 }.
Hosted rendering uses resvg-wasm with bundled fonts; bytes may differ from the
local napi renderer, so hosted PNG is a convenience surface, not part of the
byte-determinism contract. For file/URL artifacts use the local stdio server. params: source*, scale, background, fitTo, options |
verify | Parse and verify a Mermaid diagram without rendering it. Returns
{ ok, family, summary, warnings, layout: { bounds, nodes, edges } } for valid
diagrams and { ok: false, errors } for parse failures. `family` is the detected
diagram family and `summary` a one-line description — check them: ok:true only
means the diagram is structurally valid, not that it is the kind you intended.
Warnings use the la params: source* |
describe | Describe a Mermaid diagram. format=text returns { ok, text } with
one or two summary sentences; format=json returns { ok, tree } with the AX tree;
format=facts returns { ok, facts } with deterministic semantic fact lines for
machine checking (for example edge A -> B : label, member Duck +quack()). params: source*, format |
mutate | Apply a list of structured edit ops to an existing Mermaid `source` and
return the edited diagram. This is the declarative counterpart to `execute`:
plain JSON in, plain JSON out, no sandbox. Prefer it for straightforward edits;
reserve `execute` for logic the ops don't express.
Returns { ok, family, source, verify:{ ok, warnings } } on success, or
{ ok:false, family, opIndex, error } — where `err params: source*, ops* |
build | Author a new Mermaid diagram from blank by folding a list of structured ops
over an empty diagram of `family`. The declarative counterpart to hand-writing
source. Returns the same envelope as `mutate`:
{ ok, family, source, verify } or { ok:false, family, opIndex, error }.
Call `describe_sdk` for the family before authoring unfamiliar ops. params: family*, ops* |
Entries describe changes in tool definitions. They are not statements about a server, its quality or its author. The grade measures how the tool definitions fit model providers (token cost, schema compatibility, confusable names) as scored by the ToolFit engine at the time of the listing. JSON: append .json. Opt-out: how or hello@youraitools.co.