Mermaid MCP Server

by mermaidchart Your server? Claim it

answering

Mermaid MCP is answering right now. Last checked 4 min ago. It exposes 25 tools.

MCP server for Mermaid diagram validation and rendering

The linked repository no longer exists on GitHub — it was deleted or made private.

Uptime history 91 days of history · worst day 50%

91 days agonow

100.0%

Uptime 24h

184 of 184 checks

Tools

read from the server

639 ms

Response time

average over 24h

OAuth sign-in

Access

streamable-http

This one has been quiet for a while

Quiet is not dead — but it is worth knowing when it wakes up, or when someone else takes it over. We watch the repository and tell you either way.

Connect this server

Endpoint below is the one we actually reach during checks — not the one copied from a README. Last verified 4 min ago.

Claude Code Claude Desktop Codex Cursor VS Code

run in your terminal

claude mcp add mermaid-mcp --transport http https://mcp.mermaidchart.com/mcp

Settings → Connectors → Add custom connector, then paste this address

https://mcp.mermaidchart.com/mcp

~/.codex/config.toml

[mcp_servers.mermaid-mcp]
url = "https://mcp.mermaidchart.com/mcp"

.cursor/mcp.json

{
  "mcpServers": {
    "mermaid-mcp": {
      "url": "https://mcp.mermaidchart.com/mcp"
    }
  }
}

.vscode/mcp.json

{
  "servers": {
    "mermaid-mcp": {
      "type": "http",
      "url": "https://mcp.mermaidchart.com/mcp"
    }
  }
}

This endpoint answered with an authorization challenge. The server is running, and it signs you in through your browser: there is no API key to paste.

This server publishes 1 more address. The block above uses the one we reach during checks; the full list is under Endpoints below, and the author may intend a particular one for your client.

Available tools 25

Read directly from the server with tools/list, grouped by what they act on. If a tool disappears, we record the date.

generate

generate_jira_kanban_board

Generate a Mermaid kanban board from Jira issues. Issues are grouped into columns by their current status and ordered by workflow stage (To Do → In Progress → Done). Each card shows the issue summary and is a clickable link to the ticket, with optional assignee and priority badges.

generate_ticket_dependency_tree

Generate a Mermaid flowchart that visualises Jira issue dependency links for a project. Each node shows the ticket key, summary, and status, and is a clickable link to the ticket. Dashed nodes represent issues linked from outside the current filter set.

generate_ticket_diagram

Generate a Mermaid flowchart centred on a single Jira ticket. Fetches the ticket's subtasks, parent, issue links, and recent comments in one call. The focal ticket is highlighted in indigo; subtasks are grouped in a subgraph; issue links use colour-coded arrows (red thick = blocks, cyan dashed = relates to); comments appear in a rose subgraph.

generate_ticket_timeline

Generate a Mermaid diagram showing the history of a single Jira ticket using its changelog. Two views are available: - **state**: stateDiagram-v2 showing all status transitions with dates and authors, nodes coloured by status category. - **timeline** (default): Mermaid timeline grouped by month, showing status changes, assignee changes, priority changes, sprint moves, and resolutions.

mermaid

get_mermaid_syntax_document

Get comprehensive syntax documentation and examples for a specific Mermaid diagram type. Returns the official Mermaid.js documentation with syntax rules, examples, and usage instructions for the requested diagram type.

list_mermaid_files

List .mmd Mermaid files in a GitHub repository (code search with tree fallback). REQUIRES: `Github-Token` header (HTTP) or GITHUB_TOKEN / GH_TOKEN.

read_mermaid_file

Read a single .mmd file from a GitHub repository. Only paths ending in .mmd are allowed. REQUIRES: `Github-Token` header (HTTP) or GITHUB_TOKEN / GH_TOKEN.

search_mermaid_icons

Search for available Mermaid icons by provider or name. Returns icons in ready-to-use format with provider prefixes (e.g., 'aws:arch-amazon-ec2'). PERFORMANCE TIP: For faster searches, start with limit=10 and specific queries. If no suitable icons found, increase limit and retry. Supports AWS, Azure, GCP, and FontAwesome icon sets.

notion

get_notion_mermaid_diagram_by_block_id

Retrieve a single Mermaid diagram block by its block ID. Returns the diagram code and optional caption.

get_notion_page_mermaid_diagrams

Extract all Mermaid code blocks from a Notion page. Returns block ID, diagram code, and optional caption for each block.

update_notion_mermaid_diagram

Update the Mermaid source code (and optional caption) of an existing mermaid code block by its block ID.

diagram

get_diagram_summary

Generate a concise summary for a Mermaid diagram based on its content. This tool provides prompts for the LLM to generate a brief summary (2-4 sentences) highlighting the primary flow, key decisions, and outcomes.

get_diagram_title

Generate a descriptive title for a Mermaid diagram based on its content. This tool analyzes the diagram structure and content to suggest an appropriate title.

issue

create_issue

Create an issue in a GitHub repository. REQUIRES: `Github-Token` (HTTP) or GITHUB_TOKEN with issues write if creating issues in private repos.

get_issue_comments

List comments on an issue by issue number. REQUIRES: `Github-Token` (HTTP) or GITHUB_TOKEN / GH_TOKEN.

branches

list_branches

List or resolve branch names. **List mode (default):** one `GET /repos/.../branches?per_page=100&page=1` — at most 100 names, A–Z sorted in the response; `has_more` if a full page was returned. **Resolve mode:** set `branch_name` for a single `GET` branch (404 if missing). At most one GitHub API call. REQUIRES: `Github-Token` (HTTP) or GITHUB_TOKEN / GH_TOKEN.

create

create_pr

Create a new branch (git ref), one commit from the base tree with your file changes, then open a pull request in the same repository. REQUIRES: `Github-Token` (HTTP) or GITHUB_TOKEN with `contents: write` (and no existing branch with the same `headBranch` name).

insert

insert_notion_mermaid_diagram

Append a Mermaid diagram as a code block to a Notion page. The block is added at the end of the page content.

issues

list_issues

List issues for a repository (excludes pull requests). REQUIRES: `Github-Token` (HTTP) or GITHUB_TOKEN / GH_TOKEN.

pull

get_pull_comments

Get all pull request comments: both issue/PR thread comments and inline review comments, with a `type` of `issue_thread` or `review` per item. REQUIRES: `Github-Token` (HTTP) or GITHUB_TOKEN / GH_TOKEN.

pulls

list_pulls

List pull requests for a GitHub repository. REQUIRES: `Github-Token` (HTTP) or GITHUB_TOKEN / GH_TOKEN.

push

push_file

Create or update a single file on a given branch in a GitHub repository. REQUIRES: `Github-Token` (HTTP) or GITHUB_TOKEN with contents write access.

repos

list_repos

List GitHub repositories for the authenticated user, or for an organization when `org` is set. REQUIRES: `Github-Token` header (HTTP) or `GITHUB_TOKEN` / `GH_TOKEN` in the server environment.

tools

list_tools

Lists all available MCP servers and their tools in the workspace.

validate

validate_and_render_mermaid_diagram

SIMPLE RENDER TOOL - Renders Mermaid diagrams directly (Mermaid automatically validates during rendering). If successful, returns diagram image. If Mermaid validation fails, returns error details for fixing. One tool, one call, simple workflow.

Endpoints

URL	Transport	State	Latency	Checked
https://mcp.mermaidchart.com/mcp	streamable-http	sign-in	647 ms	4 min ago
https://mcp.mermaidchart.com/sse	sse	sign-in	571 ms	4 min ago

Alternatives to Mermaid MCP

same job, measured the same way

Plots MCP

by mr901

MCP server for data visualization with Mermaid charts.

125 installs/wk local only

MCP Plots

by mr901

MCP server for data visualization with Mermaid charts.

local only

Media Forge

by pavelguzenfeld

MCP server for generating diagrams, charts, presentations, and animations for Markdown documentation

50 installs/wk local only

SyntheticUser Lab MCP

by syntheticuserlab

Paid remote MCP for synthetic user testing, UX validation, analytics, checkout, and readiness.

answering

Transform Rules MCP Server

by vinhphatfsg

MCP server for CSV/JSON data transformation using YAML rules

local only

Chartforge

by crawde

MCP server for ChartForge — generate stunning charts and diagrams from natural language

98 installs/wk local only

Chartforge

by chartforgeai

MCP server for ChartForge — generate stunning charts and diagrams from natural language

local only

Semiotic

by nteract

Verified React chart generation: select, validate, repair, render, and inspect charts through MCP.

16 616 installs/wk 5 tools answering

Mermaid MCP — questions

Answers built from our own checks of this server.

What can Mermaid MCP do?

It exposes 25 tools, read directly from the server on our last check. Among them: create_issue, create_pr, generate_jira_kanban_board, generate_ticket_dependency_tree, generate_ticket_diagram, generate_ticket_timeline and 19 more. The full list with descriptions is on this page — we take it from the server itself via tools/list, not from a README. How MCP servers expose tools in the first place →

What is Mermaid MCP mostly used for?

Its tools cluster around generate, mermaid and notion. That is what this server is built to work with — the grouping comes from the actual tool names, not from a category we assigned.

Is Mermaid MCP working right now?

We send a real MCP handshake every 15 minutes. Over the last 24 hours 184 of 184 checks got a reply (100.0%), average response time 639 ms. The bar chart above shows every period we have measured.

Is Mermaid MCP still maintained?

The linked repository no longer exists on GitHub — it was deleted or made private. We show this because it changes what you can expect: an unmaintained server may keep answering for months and then stop without warning.

How do I connect Mermaid MCP?

Copy the ready config from this page. We generate it for Claude Code, Claude Desktop, Codex, Cursor and VS Code, each in the form that client actually reads. It is a remote server, so there is nothing to install — the client connects to the address. You sign in through your browser once and the client keeps the session: no key to copy, and it refuses anonymous clients.

How do you sign in to Mermaid MCP?

No API key is involved. Mermaid MCP answers our knock with an OAuth challenge, so you authorise it once in your browser and the client keeps the session. That is also why we see no tool list: it will not describe itself to an anonymous client, and that is the server working as intended, not a fault.

How fast is Mermaid MCP?

It answers our handshake in 639 ms on average, which is faster than 16% of all working MCP servers we measure. That is on the slow side — worth knowing if the tool sits inside an interactive loop. The comparison comes from our own checks across the whole registry, every 15 minutes.