# Agentic Mermaid [Health: Active]

**Category:** 📊 Data Visualization  
**Repository:** https://github.com/adewale/agentic-mermaid  
**GitHub Stars:** 72  
**npm Downloads (last month):** 2894  
**Views:** 4  
**Installs:** 0  
**Upvotes:** 0  
**Directory Page:** https://allmcps.com/mcp/agentic-mermaid

## Description
Render, verify, describe, and safely edit Mermaid diagrams through MCP.

## Claude Desktop Quick Installation
Install path detected from listing signals. Uses `npx` (confidence: high):

```json
"mcpServers": {
  "agentic-mermaid": {
    "command": "npx",
    "args": ["-y","--no-install","agentic-mermaid"]
  }
}
```

## Documentation

## What Agentic Mermaid does

Agentic Mermaid gives coding agents an MCP interface for working with Mermaid diagrams. Agents can create or modify Mermaid source, inspect whether a diagram is valid, render it into several output formats, and describe or review the resulting layout. The same project is also available as a command-line tool and JavaScript library, but the MCP server is useful when an MCP-capable agent needs diagram operations without invoking shell commands directly.

Supported render outputs include SVG, PNG, ASCII, Unicode, and JSON layout data. SVG rendering through the synchronous JavaScript API does not require a DOM or Puppeteer. Built-in visual options include styles such as `watercolor`, `blueprint`, `hand-drawn`, and `publication-figure`, along with palettes including `nord-light` and `dracula`. Styles and palettes can be combined, and custom JSON styles can define colors, fonts, strokes, fills, and backdrops.

## How it works

The local server starts over stdio with the installed package's MCP command. Agents can use the server to render diagrams or perform structured edits through the same `mermaid.*` SDK naming used by Code Mode. For an existing diagram, the recommended sequence is to parse the source, narrow it to the relevant diagram family, apply a typed mutation, verify the result, and serialize the updated Mermaid source.

Typed operations preserve modeled structure, such as changing a flowchart node label without breaking its connections. Source-preserving behavior is available for selected Class and Flowchart operations, and inputs containing unmodeled syntax retain their source. Verification checks structural and geometry issues before the result is returned.

## Setup and configuration

Install the package with npm, Bun, or pnpm. Node.js 22 or later, or Bun 1.4.0 or later, is required, and the package uses ESM imports. Start the local MCP server with:

```bash
npx --no-install agentic-mermaid mcp
```

The repository also provides an initialization command that can add an `AGENTS.md` section, a root `skills/` bundle, and an `.mcp.json` example without overwriting existing content. Agent instructions and capability discovery are available through the CLI, including `am --agent-instructions` and `am capabilities --json`.

An optional public endpoint is available at `https://agentic-mermaid.dev/mcp`. It uses MCP JSON-RPC rather than REST render requests and supports HTTP-based MCP access.

## Tools and capabilities

- Render Mermaid diagrams as SVG, PNG, ASCII, Unicode, or JSON layout.
- Apply built-in styles, palettes, and custom JSON styling.
- Parse registered Mermaid syntax and narrow it to a supported diagram family.
- Make typed, source-aware edits and verify the resulting diagram.
- Discover supported diagrams and operations with capability reporting.
- Use local files, including locally generated PNG output, through local workflows.

## Limitations and notes

The hosted endpoint is unauthenticated, limits inputs to 64 KB, and returns PNG data as base64. Hosted requests send Mermaid source or agent code to the service, so private or larger diagrams are better handled with the local stdio server. The package is ESM-only; CommonJS projects must use dynamic `import()`.

_Full upstream README: https://allmcps.com/mcp/agentic-mermaid/readme_

