Mermaid MCP Server

com.mermaidchart/mermaid-mcp

answering

Mermaid MCP is answering right now. Last checked 6 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 40 hours of history · worst hour 43%

40 hours agonow

50.0%

Uptime 24h

91 of 182 checks

Tools

read from the server

653 ms

Response time

average over 24h

open, no key

Access

streamable-http

Connect this server

Endpoint below is the one we actually reach during checks — not the one copied from a README. Last verified 6 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

~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "mermaid-mcp": {
      "url": "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

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

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	answering	594 ms	6 min ago
https://mcp.mermaidchart.com/sse	sse	answering	579 ms	8 min ago

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 91 of 182 checks got a reply (50.0%), average response time 653 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 with the file path that client actually reads. It is a remote server, so there is nothing to install — the client connects to the address.

Does Mermaid MCP need an API key?

No. Mermaid MCP completed a full MCP handshake with us as an anonymous client and listed its tools without asking for anything. All 25 of them are readable on this page. This is what we observed, not what the docs claim.

How fast is Mermaid MCP?

It answers our handshake in 653 ms on average, which is faster than 13% 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.