Agentic Mermaid
adewale/agentic-mermaid
Render, verify, describe, and safely edit Mermaid diagrams through MCP.
- GitHub stars
- 69
- tools
- 9
- transport
- STDIO, HTTP
- last updated
- Nov 2, 2026
Install
From registry metadata$ npx add-mcp https://agentic-mermaid.dev/mcp --name agentic-mermaidRun in your terminal. add-mcp asks which agents to add it to (Claude Code, Codex, Cursor and more). Add -g to install it for every project.
Review the command, arguments and environment values before installing. MCP servers run with your local permissions.
Other ways
Claude Code
$ claude mcp add --transport http agentic-mermaid https://agentic-mermaid.dev/mcpRun in your terminal. Add --scope user to make it available in every project.
Tools
Verified live · 9 toolsVerified live against the running server on Nov 6, 2026.
executeRun JavaScript in an isolated sandbox; return a value. No promises, async/await, dynamic import, or type annotations. SVG/ASCII/layout enforce security:'strict', embedFontImport:false. SDK: type DiagramKind='flowchart'|'state'|'sequence'|'timeline'|'class'|'er'|'journey'|'arch...2 params
Run JavaScript in an isolated sandbox; return a value. No promises, async/await, dynamic import, or type annotations. SVG/ASCII/layout enforce security:'strict', embedFontImport:false. SDK: type DiagramKind='flowchart'|'state'|'sequence'|'timeline'|'class'|'er'|'journey'|'arch...
Parameters* required
code*stringJavaScript to execute; mermaid.* SDK is global.
timeoutMsintegerOptional CPU-time budget (default 5000ms, max 30000ms).
describe_sdkReturn version-matched mutation operations for one diagram family, or use capability=resolved-scene for painted geometry, runtime limits and typed errors. Use detail=signatures for the compact op menu or detail=fields (default) for exact field types, required flags, enum value...3 params
Return version-matched mutation operations for one diagram family, or use capability=resolved-scene for painted geometry, runtime limits and typed errors. Use detail=signatures for the compact op menu or detail=fields (default) for exact field types, required flags, enum value...
Parameters* required
capabilitystringRead-only rendering capability; use instead of family.one of
resolved-scenedetailstringsignatures for a compact menu; fields for the complete schema (default).one of
signatures · fieldsfamilystringDiagram family whose mutation operations are needed.one of
flowchart · state · sequence · timeline · class · errender_svgRender 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.2 params
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.
Parameters* required
optionsobjectShared advanced RenderOptions object. Styles accept a registered Look (crisp, hand-drawn, excalidraw, pen-and-ink, freehand, watercolor, blueprint, look:tufte, accessible-high-contrast, patent-draw...
source*stringMermaid source.
render_asciiRender 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.4 params
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.
Parameters* required
optionsobjectShared advanced RenderOptions object, including style/palette/config/security.
source*stringMermaid source.
targetWidthintegerHard maximum line width in terminal display cells.
useAsciibooleantrue = ASCII characters, false = Unicode (default).
render_pngRasterize 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 u...6 params
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 u...
Parameters* required
backgroundstringPortable basic color or hex color painted behind the raster artifact.
fitToobjectExactly one output width or height constraint.
minLabelPxnumberLegibility floor in effective px: the render warns (BELOW_READABLE_SIZE) when fitTo/scale rasterizes the smallest configured text below it. 0 disables.default: 9
optionsobjectShared advanced RenderOptions object.
scalenumberPositive output scale used when no fitTo constraint is supplied.default: 2
source*stringMermaid source.
verifyParse and verify source, structure, and renderability. This runs the graphical pipeline. 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 `su...1 params
Parse and verify source, structure, and renderability. This runs the graphical pipeline. 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 `su...
Parameters* required
source*stringMermaid source.
describeDescribe 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, m...2 params
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, m...
Parameters* required
formatstringtext (default), json AX tree, or facts semantic read-back.one of
text · json · factssource*stringMermaid source.
mutateApply 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 expres...3 params
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 expres...
Parameters* required
modestringSource-preserving mode edits owned source ranges without regenerating unsupported syntax.one of
structured · source-preservingdefault: structuredops*arrayNon-empty ordered list of edit ops; each is { kind, ...fields }.
source*stringMermaid source to edit.
buildAuthor 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 }. Cal...2 params
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 }. Cal...
Parameters* required
family*stringDiagram family to author (one of: zenuml, eventmodeling, flowchart, state, sequence, timeline, class, er, journey, architecture, xychart, pie, quadrant, gantt, mindmap, gitgraph, radar, sankey, c4,...
ops*arrayNon-empty ordered list of ops; each is { kind, ...fields }.
Sponsors
Promote your product here
Agent CaffeineSponsoredClose your lid, come back to finished work
LLMond HighlightsSponsoredThe AI tools worth your time, every Monday
SnugSponsoredThe clipboard manager you and your agent can use, safely
Vinena StudioSponsoredWe build premium apps, websites and AI workflows for you
knobsSponsoredSee your site on any phone, any day, in any language
AcheliaSponsoredNative herdr client for iOS and macOS
WaxSponsoredBlock anything with supervision, without erasing your iPhone
Agent CaffeineSponsoredClose your lid, come back to finished workLLMond HighlightsSponsoredThe AI tools worth your time, every MondaySnugSponsoredThe clipboard manager you and your agent can use, safelyVinena StudioSponsoredWe build premium apps, websites and AI workflows for youknobsSponsoredSee your site on any phone, any day, in any languageAcheliaSponsoredNative herdr client for iOS and macOSWaxSponsoredBlock anything with supervision, without erasing your iPhoneReadme
Agentic Mermaid
Beautiful diagrams, made with your agent.
Agentic Mermaid helps coding agents create styled diagrams from Mermaid source and edit existing diagrams through typed operations. Export SVG or PNG for documents, and ASCII or Unicode for terminal review.
It is forked from lukilabs/beautiful-mermaid. Published on npm as agentic-mermaid; the GitHub repository is adewale/agentic-mermaid; the live site is agentic-mermaid.dev.
A login flow with MFA, rendered directly by Agentic Mermaid. Mermaid source · Style and reproduction command
Ask your coding agent:
Details
- Repository
- github.com/adewale/agentic-mermaid
- Website
- agentic-mermaid.dev
- Categories
- AI & LLM Tools, Design & Creative
- Package
agentic-mermaid- Transport
- STDIO, HTTP
- Registry
- MCP registry, active
- Tools verified
- Nov 6, 2026
