Agentic Mermaid
Render, verify and safely edit styled Mermaid diagrams from an AI agent
- Pricing
- Open source
- Platforms
- CLI, Web, self-hosted
- Runs
- Locally or Remotely
- Version
- 0.5.6
- Listing updated
- 2 days ago
About Agentic Mermaid
Agentic Mermaid is an open-source MCP server for developer tools. It can run locally on your machine or as a hosted remote server.
Agentic Mermaid is a fork of beautiful-mermaid built so coding agents do not guess from pixels or regenerate a whole diagram for a small change. Existing diagrams go through a loop of parse, narrow to the diagram family, apply a typed mutation, verify and serialise back to Mermaid source, so the text stays reviewable. New diagrams start as Mermaid source and are checked before export.
The site lists 25 diagram families, 16 built-in styles such as watercolor, blueprint, hand-drawn and publication-figure, and 20 palettes, which can be combined as a style stack or replaced by custom JSON styles. Output can be SVG, PNG, ASCII, Unicode or layout JSON, and SVG rendering needs no browser or DOM. A verification step reports structural, geometric and lint warnings with stable codes.
The same capabilities are offered as a library, a CLI named am, and MCP. The hosted MCP uses a code-mode pattern in which the agent runs the whole loop inside one execute call with the SDK bound as mermaid. A stdio package and self-hosting are also available. It needs Node.js 22 or later, or Bun 1.4.0 or later.
Install
Run in a terminal
claude mcp add --transport http agentic-mermaid https://agentic-mermaid.dev/mcpAdd to Settings → Connectors → Add custom connector
https://agentic-mermaid.dev/mcpAdd to ~/.cursor/mcp.json
{
"mcpServers": {
"agentic-mermaid": {
"url": "https://agentic-mermaid.dev/mcp"
}
}
}Add to .vscode/mcp.json
{
"servers": {
"agentic-mermaid": {
"type": "http",
"url": "https://agentic-mermaid.dev/mcp"
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"agentic-mermaid": {
"serverUrl": "https://agentic-mermaid.dev/mcp"
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"agentic-mermaid": {
"type": "http",
"url": "https://agentic-mermaid.dev/mcp"
}
}
}Tools this server provides (1)
Taken from the project documentation; the running server may differ.
- execute
- Runs code that uses the bound mermaid SDK to create, edit, verify and render diagrams.
What it does
- Typed edits
- Changes diagrams through parse, mutate and serialise steps instead of string edits.
- Verification warnings
- Reports structural, geometric and lint problems with stable codes before export.
- Styles and palettes
- Combines built-in looks with palettes or custom JSON styles for brand fit.
- Multiple outputs
- Exports SVG, PNG, ASCII, Unicode and layout JSON from the same source.
- Browserless rendering
- Renders SVG synchronously without a DOM or Puppeteer.
- Library, CLI and MCP
- Offers the same loop through an import, an am command and a hosted or stdio server.
Good for
- Draw an architecture map from a prompt and return an SVG
- Add an edge to an existing flowchart without rewriting it
- Match diagrams to a brand palette across a repo
- Preview a diagram in the terminal as Unicode
- Check a generated diagram for structural warnings before publishing
Pricing
Open source
Prices change. Check agentic-mermaid.dev before you buy.
Agentic Mermaid FAQ
What does the MCP expose?
A code-mode surface where the agent calls execute with code that uses the bound mermaid SDK to parse, mutate, verify and serialise diagrams.
Which formats can it export?
SVG, PNG, ASCII, Unicode and layout JSON.
What are the requirements?
Node.js 22 or later, or Bun 1.4.0 or later. The package is ESM-only.
Can I self-host it?
Yes. The registry lists an npm stdio package, and the site mentions self-hosted servers.
Is Agentic Mermaid free?
Yes. Agentic Mermaid is open source, so you can use and self-host it for free.
How do I add Agentic Mermaid to Claude Code?
Run this command in your terminal: claude mcp add --transport http agentic-mermaid https://agentic-mermaid.dev/mcp
What are the best alternatives to Agentic Mermaid?
The closest alternatives to Agentic Mermaid are REA, HyperFrames by HeyGen, Codebase Memory, GitHub and Serena MCP: the IDE for your agent.
Alternatives to Agentic Mermaid

REA
MCP serverCLI and MCP server that lets coding agents reverse engineer apps and binaries
Runs locally- Open source
- 464K GitHub stars
- Developer tools

HyperFrames by HeyGen
MCP serverHosted MCP connector for creating and rendering videos from HTML through AI chat
- Remote
- Freemium
- 85.3K GitHub stars
- Design and media

Codebase Memory
MCP serverLocal MCP server that builds a code knowledge graph for AI coding agents
Runs locally- Open source
- 48.7K GitHub stars
- Knowledge and memory

GitHub
MCP serverOfficial MCP server connecting AI assistants to GitHub repos, issues and workflows
Not checked yet- Remote
- Open source
- 34.5K GitHub stars
- Developer tools

Serena MCP: the IDE for your agent
MCP serverMCP toolkit giving coding agents symbol-level code retrieval and editing
Runs locally- Open source
- 31.5K GitHub stars
- Developer tools

XERJ
MCP serverLocal search engine for AI agents with cited answers over your code and docs
Runs locally- Open source
- 19.2K GitHub stars
- Knowledge and memory