Skip to content
verify mcp Beta VerifyMCP is currently in beta. If you notice any issues, get in touch and we’ll put it right.

com.mermaidchart/mermaid-mcp

REMOTE · MCP.MERMAIDCHART.COM · 2 COMPONENTS · SCANNED SEP 20

MCP server for Mermaid diagram validation and rendering

0 this week 76 Trust /100
Trust breakdown (7 categories)

How this component scores in each security and reliability category. Every signal is checked automatically against the live server, and we only credit what we can confirm. How we score → Why this is hard to score →

Endpoint Security57
Transport & Reachability100
Schema Quality & AI Usability68
  • AI-judged instruction clarity (good).Pass
  • Context-footprint check failed: tool/resource definitions use about 3828 tokens (~153/item across 25 items; 25 tools + 0 resources), over budget; trim descriptions and params. See how to fix → Fail
  • Usage-examples check failed: none of the tools include examples. See how to fix → Fail
Stability & Change Management100
  • No destabilizing schema changes in the last 30 days.Pass
Tool Coverage91
  • 100% of tools have a non-trivial description (not blank, and not just the tool's name).Pass
  • 72% of tool parameters carry a description.Partial
Tool Safety100
  • No prompt-injection markers were found in the server instructions, tool names or descriptions we captured.Pass
  • We read all 25 captured tool definition(s), and no name or description among them implies an irreversible operation.Pass
  • An AI judge read all 25 captured unit(s) of tool text and found none that tries to manipulate the model reading it.Pass
Capabilities100
  • Implements a supported MCP spec version (2025-11-25); the latest is 2026-07-28.Pass
Install

How do I install the com.mermaidchart/mermaid-mcp server?

com.mermaidchart/mermaid-mcp is a hosted endpoint at https://mcp.mermaidchart.com/mcp, so there is nothing to install locally. Ready-made configuration for Claude, Cursor, VS Code, Codex and 5 more is on this page, copied from each client's own documentation.

remote · mcp.mermaidchart.com

# add to Claude Code
claude mcp add --transport http com-mermaidchart-mermaid-mcp 'https://mcp.mermaidchart.com/mcp'
// .cursor/mcp.json
{
  "mcpServers": {
    "com-mermaidchart-mermaid-mcp": {
      "url": "https://mcp.mermaidchart.com/mcp"
    }
  }
}
// .vscode/mcp.json
{
  "servers": {
    "com-mermaidchart-mermaid-mcp": {
      "type": "http",
      "url": "https://mcp.mermaidchart.com/mcp"
    }
  }
}
# ~/.codex/config.toml
[mcp_servers.com-mermaidchart-mermaid-mcp]
url = "https://mcp.mermaidchart.com/mcp"
// opencode.json
{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "com-mermaidchart-mermaid-mcp": {
      "type": "remote",
      "url": "https://mcp.mermaidchart.com/mcp",
      "enabled": true
    }
  }
}
# add to OpenClaw
openclaw mcp add com-mermaidchart-mermaid-mcp --url 'https://mcp.mermaidchart.com/mcp' --transport streamable-http
# ~/.hermes/config.yaml
mcp_servers:
  com-mermaidchart-mermaid-mcp:
    url: "https://mcp.mermaidchart.com/mcp"
// ~/.netclaw/config/netclaw.json
{
  "McpServers": {
    "com-mermaidchart-mermaid-mcp": {
      "Transport": "http",
      "Url": "https://mcp.mermaidchart.com/mcp"
    }
  }
}
# add to Vellum
assistant mcp add com-mermaidchart-mermaid-mcp -t streamable-http -u 'https://mcp.mermaidchart.com/mcp'
// mcp.json
{
  "mcpServers": {
    "com-mermaidchart-mermaid-mcp": {
      "type": "http",
      "url": "https://mcp.mermaidchart.com/mcp"
    }
  }
}

The mcpServers block is a cross-client convention. Remote transports vary, so check your client's docs.

Changelog

Every change we have recorded for this component, newest first. Security-relevant changes are always shown. ▲ marks a change for the better, ▼ a change for the worse; unmarked changes are neutral.

  • 26 Aug 26 0
    • We updated how we score, so this day's move reflects our rubric, not a change to the server See what changed → functional
  • 25 Aug 26 +1
    • Stability: 0.97 → pass security
  • 24 Aug 26 +1

    No change was recorded against any check on this day. Stability & Change Management went from 93 to 97. That category is still filling its 30-day observation window: 28 days of observed history at the previous scan, 29 at this one. The score rises as the window fills, whether or not the server changes.

  • 11 Aug 26 0
    • We updated how we score, so this day's move reflects our rubric, not a change to the server See what changed → functional
  • 31 Jul 26 0
    • We updated how we score, so this day's move reflects our rubric, not a change to the server See what changed → functional
  • 30 Jul 26 0
    • We updated how we score, so this day's move reflects our rubric, not a change to the server See what changed → functional
  • 27 Jul 26 0
    • We updated how we score, so this day's move reflects our rubric, not a change to the server See what changed → functional
  • 26 Jul 26 0

    First indexed and scored.

Diagnostics

Diagnostic detail from the automated scan of this channel: what the scanner observed at each step, so you can see exactly where a check passed or failed. It is informational only and never changes the trust score.

Captured 20 Sept 2026 · Probed https://mcp.mermaidchart.com/mcp

TLS valid

Negotiated TLS 1.3 with TLS_AES_128_GCM_SHA256 .

Subject Issuer Valid from Valid until Key Signature Serial
CN=*.mcp-prod.mdct.co CN=Amazon RSA 2048 M04,O=Amazon,C=US 6 Aug 2026 19 Feb 2027 RSA 2048 SHA256-RSA f17539f09d9d79087f946d12efbb5ea
SANs: *.mcp-prod.mdct.co, mcp2.mermaidchart.com, mcp.mermaidchart.com, mcp.mermaid.ai
CN=Amazon RSA 2048 M04,O=Amazon,C=US (CA) CN=Amazon Root CA 1,O=Amazon,C=US 23 Aug 2022 23 Aug 2030 RSA 2048 SHA256-RSA 773124f2a952e3ed18a58bdb85d1bc0ce5f27
CN=Amazon Root CA 1,O=Amazon,C=US (CA) CN=Starfield Services Root Certificate Authority - G2,O=Starfield Technologies\, Inc.,L=Scottsdale,ST=Arizona,C=US 25 May 2015 31 Dec 2037 RSA 2048 SHA256-RSA 67f944a2a27cdf3fac2ae2b01f908eeb9c4c6

Background: What to check on a remote MCP endpoint →

DNSSEC insecure

Validation of mcp.mermaidchart.com. Not signed

Zone DS Keys Algorithms Outcome
. trust_anchor 20326, 38696 8, 8 Verified
com. present 19718 13 Verified
mermaidchart.com. absent Unsigned (proven) parent-signed NSEC/NSEC3 proves an unsigned delegation
Authentication No authorisation required

The endpoint answered without asking for a token. Anyone who knows the URL can reach it.

Result No authorisation required
HTTP status 200
Header Value
content-security-policy default-src 'none';

Background: How OAuth 2.1 works in the 2026 MCP spec →

Transports 2 probes
Transport URL Outcome Status Location
streamable-http https://mcp.mermaidchart.com/mcp Verified 200
http (plaintext) http://mcp.mermaidchart.com/mcp HTTPS enforced 301 https://mcp.mermaidchart.com:443/mcp
MCP tools · 25 exposed · ~3,828 tokens

The tools this component advertises to a client, with an estimated token cost for each. Expand a tool to see its parameters and schema. The per-tool counts are indicative and are not scored directly; the schema's total context footprint is one signal in Schema Quality & AI Usability. A tool's description is untrusted text the model reads on every call, which is what makes this list a security surface and not just an inventory: how tool poisoning works →

Tool Tokens
create_issue ~115

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

NameTypeReqDescription
bodystringIssue body in markdown.
clientNamestringyesREQUIRED: The name of the client/agent using the MCP server for analytics tracking.
labelsarrayLabel names (must already exist in the repository).
ownerstringyes
repostringyes
titlestringyes

No output schema declared.

No examples provided.

create_pr ~203

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).

NameTypeReqDescription
baseBranchstringBranch to base the PR on (e.g. main). Defaults to the repo default branch.
bodystringyesPR description (markdown).
clientNamestringyesREQUIRED: The name of the client/agent using the MCP server for analytics tracking.
commitMessagestringyesSingle commit message for the file changes.
filesarrayyesFiles to add or update.
headBranchstringyesName of the new branch (must not already exist on the remote).
ownerstringyes
repostringyes
titlestringyes

No output schema declared.

No examples provided.

generate_jira_kanban_board ~215

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.

NameTypeReqDescription
assigneestringFilter by assignee — Jira account ID, display name, or 'currentUser()'.
clientNamestringyesREQUIRED: The name of the client/agent using the MCP server for analytics tracking.
issueTypestringFilter by issue type, e.g. 'Story', 'Bug', 'Task'.
maxResultsintegerMaximum number of issues to fetch (1–100, default 50).
projectKeystringyesREQUIRED: Jira project key, e.g. 'PROJ' or 'MYTEAM'.
sprintstringFilter by sprint name or numeric ID, e.g. 'Sprint 12' or '42'.

No output schema declared.

No examples provided.

generate_ticket_dependency_tree ~371

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.

NameTypeReqDescription
assigneestringFilter by assignee — Jira account ID, display name, or 'currentUser()'.
clientNamestringyesREQUIRED: The name of the client/agent using the MCP server for analytics tracking.
colorModestringColor scheme for the diagram: 'light' (default pastel fills), 'dark' (deep fills for dark backgrounds), or 'none' (no fill/stroke overrides, inherits the Mermaid theme).
createdAfterstringInclude only issues created on or after this date, ISO format: '2024-01-15'.
createdBeforestringInclude only issues created on or before this date, ISO format: '2024-03-31'.
maxResultsintegerTarget number of issues to render in the tree (1–100, default 50).
projectKeystringyesREQUIRED: Jira project key, e.g. 'PROJ' or 'MYTEAM'. Used as the base JQL project filter.
reporterstringFilter by reporter — Jira account ID or display name.
sprintstringFilter by sprint name or numeric ID, e.g. 'Sprint 12' or '42'.
statusstringFilter by issue status, e.g. 'In Progress', 'To Do', 'Done'.
useUrlShortenerbooleanShorten the preview/edit URL via Short.io. Disable to get the full unshortened URL (default true).

No output schema declared.

No examples provided.

generate_ticket_diagram ~185

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.

NameTypeReqDescription
clientNamestringyesREQUIRED: The name of the client/agent using the MCP server for analytics tracking.
colorModestringColor scheme for the diagram: 'light' (default pastel fills), 'dark' (deep fills for dark backgrounds), or 'none' (no fill/stroke overrides, inherits the Mermaid theme).
ticketKeystringyesREQUIRED: Jira issue key, e.g. 'MC-123' or 'PROJ-42'.

No output schema declared.

No examples provided.

generate_ticket_timeline ~166

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.

NameTypeReqDescription
clientNamestringyesREQUIRED: The name of the client/agent using the MCP server for analytics tracking.
ticketKeystringyesREQUIRED: Jira issue key, e.g. 'MC-123' or 'PROJ-42'.
viewstringDiagram view to generate. 'state' shows status transitions; 'timeline' shows all field changes over time.

No output schema declared.

No examples provided.

get_diagram_summary ~139

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.

NameTypeReqDescription
clientNamestringyesREQUIRED: The name of the client/agent using the MCP server (e.g., 'claude', 'cursor', 'vscode', 'chatgpt', 'copilot') for analytics tracking.
contextHintstringOptional: Context hint to help generate a more accurate summary.
diagramContentstringyesThe Mermaid diagram content/code for which to generate a summary.

No output schema declared.

No examples provided.

get_diagram_title ~163

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.

NameTypeReqDescription
clientNamestringyesREQUIRED: The name of the client/agent using the MCP server (e.g., 'claude', 'cursor', 'vscode', 'chatgpt', 'copilot') for analytics tracking.
currentTitlestringOptional: The current title of the diagram, if any, for context.
diagramContentstringyesThe Mermaid diagram content/code for which to generate a title.
diagramTypestringOptional: The type of Mermaid diagram (e.g., 'flowchart', 'sequenceDiagram', 'gantt') for better context in title generation.

No output schema declared.

No examples provided.

get_issue_comments ~118

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

NameTypeReqDescription
clientNamestringyesREQUIRED: The name of the client/agent using the MCP server for analytics tracking.
issue_numberintegeryesIssue number (not a PR number unless the PR is also addressed as an issue on GitHub).
ownerstringyes
pageinteger
per_pageinteger
repostringyes

No output schema declared.

No examples provided.

get_mermaid_syntax_document ~145

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.

NameTypeReqDescription
clientNamestringyesREQUIRED: The name of the client/agent using the MCP server (e.g., 'claude', 'cursor', 'vscode', 'chatgpt', 'copilot') for analytics tracking.
diagramTypestringyesThe type of Mermaid diagram to get syntax documentation for (e.g., 'flowchart', 'sequenceDiagram', 'architecture-beta', 'gantt', 'gitgraph', 'classDiagram', 'stateDiagram', etc.).

No output schema declared.

No examples provided.

get_notion_mermaid_diagram_by_block_id ~91

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

NameTypeReqDescription
blockIdstringyesThe Notion block ID of the mermaid code block (e.g. from get_notion_page_mermaid_diagrams).
clientNamestringyesREQUIRED: The name of the client/agent using the MCP server for analytics tracking.

No output schema declared.

No examples provided.

get_notion_page_mermaid_diagrams ~94

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

NameTypeReqDescription
clientNamestringyesREQUIRED: The name of the client/agent using the MCP server for analytics tracking.
pageUrlstringyesURL of the Notion page (e.g. https://www.notion.so/My-Page-abc123...).

No output schema declared.

No examples provided.

get_pull_comments ~127

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.

NameTypeReqDescription
clientNamestringyesREQUIRED: The name of the client/agent using the MCP server for analytics tracking.
ownerstringyes
pageinteger
per_pageinteger
pull_numberintegeryesPull request number.
repostringyes

No output schema declared.

No examples provided.

insert_notion_mermaid_diagram ~107

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

NameTypeReqDescription
captionstringOptional caption displayed below the code block.
clientNamestringyesREQUIRED: The name of the client/agent using the MCP server for analytics tracking.
codestringyesMermaid diagram source code.
pageUrlstringyesURL of the Notion page to insert the diagram into.

No output schema declared.

No examples provided.

list_branches ~183

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.

NameTypeReqDescription
branch_namestringExact branch name. When non-empty, returns that branch only. Omit to fetch the first 100 branches only.
clientNamestringyesREQUIRED: The name of the client/agent using the MCP server for analytics tracking.
ownerstringyes
repostringyes

No output schema declared.

No examples provided.

list_issues ~151

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

NameTypeReqDescription
clientNamestringyesREQUIRED: The name of the client/agent using the MCP server for analytics tracking.
directionstring
labelsstringComma-separated label names (GitHub API format).
ownerstringyes
pageinteger
per_pageinteger
repostringyes
sincestringISO 8601: only issues updated at or after this time.
sortstring
statestring

No output schema declared.

No examples provided.

list_mermaid_files ~117

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

NameTypeReqDescription
clientNamestringyesREQUIRED: The name of the client/agent using the MCP server for analytics tracking.
ownerstringyesRepository owner (user or organization).
refstringOptional branch, tag, or commit for tree fallback when code search is unavailable.
repostringyesRepository name.

No output schema declared.

No examples provided.

list_pulls ~98

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

NameTypeReqDescription
clientNamestringyesREQUIRED: The name of the client/agent using the MCP server for analytics tracking.
ownerstringyes
pageinteger
per_pageinteger
repostringyes
statestring

No output schema declared.

No examples provided.

list_repos ~143

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.

NameTypeReqDescription
clientNamestringyesREQUIRED: The name of the client/agent using the MCP server for analytics tracking.
orgstringOptional: organization login. If set, lists that org's repositories; otherwise lists repos for the authenticated user.
pageinteger
per_pageinteger
typestringUser repo filter; ignored when `org` is set.

No output schema declared.

No examples provided.

list_tools ~68

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

NameTypeReqDescription
clientNamestringOPTIONAL: The name of the client/agent using the MCP server (e.g., 'claude', 'cursor', 'vscode', 'chatgpt', 'copilot') for analytics tracking.

No output schema declared.

No examples provided.

push_file ~142

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.

NameTypeReqDescription
branchstringyesBranch to commit to.
clientNamestringyesREQUIRED: The name of the client/agent using the MCP server for analytics tracking.
contentstringyesFull file content.
messagestringyesCommit message.
ownerstringyes
pathstringyes
repostringyes
shastringExisting blob SHA to update; omit to create or to let the service detect.

No output schema declared.

No examples provided.

read_mermaid_file ~131

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.

NameTypeReqDescription
clientNamestringyesREQUIRED: The name of the client/agent using the MCP server for analytics tracking.
ownerstringyes
pathstringyesPath to the .mmd file in the repository.
refstringOptional: branch, tag, or commit SHA; defaults to the default branch.
repostringyes

No output schema declared.

No examples provided.

search_mermaid_icons ~238

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.

NameTypeReqDescription
clientNamestringyesREQUIRED: The name of the client/agent using the MCP server (e.g., 'claude', 'cursor', 'vscode', 'chatgpt', 'copilot') for analytics tracking.
limitnumberOptional: Maximum number of results to return per provider. Defaults to 10 for performance. Increase if needed.
providerstringOptional: Filter by specific provider ('aws', 'azure', 'gcp', 'fa'). If not provided, searches all providers.
querystringyesSearch query for icons (e.g., 'aws', 'azure', 'gcp', 'fa', 'lambda', 's3', 'database'). Use specific terms for better results.

No output schema declared.

No examples provided.

update_notion_mermaid_diagram ~110

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

NameTypeReqDescription
blockIdstringyesThe Notion block ID of the mermaid code block to update.
captionstringOptional new caption. Omit to clear the existing caption.
clientNamestringyesREQUIRED: The name of the client/agent using the MCP server for analytics tracking.
codestringyesNew Mermaid diagram source code.

No output schema declared.

No examples provided.

validate_and_render_mermaid_diagram ~208

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.

NameTypeReqDescription
clientNamestringyesREQUIRED: The name of the client/agent using the MCP server (e.g., 'claude', 'cursor', 'vscode', 'chatgpt', 'copilot') for analytics tracking.
diagramTypestringyesThe type of Mermaid diagram (e.g., 'flowchart', 'sequenceDiagram', 'gantt').
mermaidCodestringyesMermaid code to render. Mermaid validates automatically during rendering - if invalid, tool returns error details for fixing.
promptstringyesA text description of the diagram to generate.
useUrlShortenerbooleanWhether to use URL shortening for the Mermaid link. Defaults to true, set to false to disable shortening.

No output schema declared.

No examples provided.

Common questions

What is the com.mermaidchart/mermaid-mcp server?

com.mermaidchart/mermaid-mcp is listed in the public MCP registry as com.mermaidchart/mermaid-mcp. MCP server for Mermaid diagram validation and rendering. This page covers its hosted endpoint (https://mcp.mermaidchart.com/mcp).

Is the com.mermaidchart/mermaid-mcp server safe to use?

com.mermaidchart/mermaid-mcp scores 76 out of 100 on VerifyMCP. That is a record of what we were able to check automatically, not an endorsement. The category breakdown on this page shows every signal behind the number, including the ones we could not confirm.

What tools does the com.mermaidchart/mermaid-mcp server expose?

com.mermaidchart/mermaid-mcp exposes 25 tools: validate_and_render_mermaid_diagram, get_diagram_title, get_diagram_summary, search_mermaid_icons, get_mermaid_syntax_document, and 20 more. Their descriptions and schemas cost roughly 3,828 tokens of context every time the server is loaded.

Does the com.mermaidchart/mermaid-mcp server require authentication?

No. We connected to com.mermaidchart/mermaid-mcp without credentials and it answered, so anything it exposes is reachable by anyone who knows the address.

Is the com.mermaidchart/mermaid-mcp server still maintained?

com.mermaidchart/mermaid-mcp is still listed as active in the MCP registry. We last reached this channel on 20 September 2026. Those dates come from our own scans of the registry and the channel itself, not from anything the publisher announced.