# Agentic Mermaid

> Agentic Mermaid is an open-source MCP server for developer tools. Render, verify and safely edit styled Mermaid diagrams from an AI agent. It can run locally on your machine or as a hosted remote server.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, Web, self-hosted, API
- **Website:** https://agentic-mermaid.dev
- **Repository:** https://github.com/adewale/agentic-mermaid
- **MCP Registry name:** io.github.adewale/agentic-mermaid
- **Categories:** developer tools, design and media
- **Listing updated:** 2026-11-15

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http agentic-mermaid https://agentic-mermaid.dev/mcp
```

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://agentic-mermaid.dev/mcp
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "agentic-mermaid": {
      "url": "https://agentic-mermaid.dev/mcp"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "agentic-mermaid": {
      "type": "http",
      "url": "https://agentic-mermaid.dev/mcp"
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "agentic-mermaid": {
      "serverUrl": "https://agentic-mermaid.dev/mcp"
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "agentic-mermaid": {
      "type": "http",
      "url": "https://agentic-mermaid.dev/mcp"
    }
  }
}
```

## Tools

- `execute`: Runs code that uses the bound mermaid SDK to create, edit, verify and render diagrams.

## 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

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [HyperFrames by HeyGen](https://ai-powered.com/mcp/hyperframes-by-heygen): HyperFrames by HeyGen is a freemium MCP server for design and media.
- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [GitHub](https://ai-powered.com/mcp/github-2): GitHub is an open-source MCP server for developer tools.
- [Serena MCP: the IDE for your agent](https://ai-powered.com/mcp/serena-mcp-the-ide-for-your-agent): Serena MCP: the IDE for your agent is an open-source MCP server for developer tools.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.
- [ffmpeg-skill](https://ai-powered.com/mcp/ffmpeg-skill): ffmpeg-skill is an open-source MCP server for design and media.
- [Ouroboros](https://ai-powered.com/mcp/ouroboros): Ouroboros is an open-source MCP server for developer tools.

---
Source: https://ai-powered.com/mcp/agentic-mermaid
