Mermaid Chart MCP Server

by mermaid-chart Your server? Claim it

answering

Mermaid Chart is answering right now. Last checked 13 min ago. It exposes 25 tools.

Uptime history 91 days of history · worst day 98%

91 days agonow

100.0%

Uptime 24h

91 of 91 checks

Tools

read from the server

637 ms

Response time

average over 24h

OAuth sign-in

Access

streamable-http

Nothing serious here today

Today is the operative word: we check Mermaid Chart every 15 minutes and re-read its code on every release. Watch it and you find out the day that stops being true.

Connect this server

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

Claude Code Claude Desktop Codex Cursor VS Code

run in your terminal

claude mcp add mcp --transport http https://mcp.mermaid.ai/mcp

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

https://mcp.mermaid.ai/mcp

~/.codex/config.toml

[mcp_servers.mcp]
url = "https://mcp.mermaid.ai/mcp"

.cursor/mcp.json

{
  "mcpServers": {
    "mcp": {
      "url": "https://mcp.mermaid.ai/mcp"
    }
  }
}

.vscode/mcp.json

{
  "servers": {
    "mcp": {
      "type": "http",
      "url": "https://mcp.mermaid.ai/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.

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.mermaid.ai/mcp	streamable-http	sign-in	628 ms	13 min ago

Alternatives to Mermaid Chart

same job, measured the same way

Plots MCP

by mr901

MCP server for data visualization with Mermaid charts.

140 installs/wk local only

MCP Plots

by mr901

MCP server for data visualization with Mermaid charts.

local only

Diagramport

by cloudcorprecords

Generate Mermaid diagrams and charts from Mermaid syntax, validated locally.

285 installs/wk local only

diagonaldiagrams

by lucas19919

Diagrams and charts for agents: Mermaid or a spec in, an audited SVG out.

278 installs/wk local only

Zovo Org Chart Maker

by theluckystrike

Org charts from a team list

1 tools answering

Flowsimp

by flowsimp

Turn Mermaid or an indented outline into an editable flowchart link. Completely free, no API key.

2 tools answering

Mermaid MCP

by mermaidchart

MCP server for Mermaid diagram validation and rendering

25 tools answering

Owid

by pipeworx-io

OWID MCP — Our World in Data chart/indicator access (free, no auth)

344 installs/wk 47 tools answering

Mermaid Chart — questions

Answers built from our own checks of this server.

What can Mermaid Chart 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 Chart 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 Chart working right now?

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

How do I connect Mermaid Chart?

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 Chart?

No API key is involved. Mermaid Chart 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 Chart?

It answers our handshake in 637 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.