protogrid

Search / com.mermaidchart/mermaid-mcp

mermaid-mcp

R2 · OAuth, once

MCP server for Mermaid diagram validation and rendering

v1.0.0 · active · repository · descriptor JSON · versions

An agent can connect after a one-time OAuth consent by a human.Remote endpoint behind OAuth 2. Tokens stay with the agent; the registry only exposes the authorization metadata.
Quality89good
Trust78of 100
Uptime, 30 days100%
Latency p50622 ms

Connect

8 clients · secrets stay placeholders
{
  "mcpServers": {
    "mermaid-mcp": {
      "type": "http",
      "url": "https://mcp.mermaidchart.com/mcp"
    }
  }
}
claude mcp add --transport http mermaid-mcp https://mcp.mermaidchart.com/mcp
[mcp_servers.mermaid-mcp]
url = "https://mcp.mermaidchart.com/mcp"
{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "mermaid-mcp": {
      "type": "remote",
      "url": "https://mcp.mermaidchart.com/mcp",
      "enabled": true
    }
  }
}
{
  "mcpServers": {
    "mermaid-mcp": {
      "type": "http",
      "url": "https://mcp.mermaidchart.com/mcp"
    }
  },
  "deeplink": "cursor://anysphere.cursor-deeplink/mcp/install?name=mermaid-mcp&config=eyJ0eXBlIjoiaHR0cCIsInVybCI6Imh0dHBzOi8vbWNwLm1lcm1haWRjaGFydC5jb20vbWNwIn0%3D"
}
{
  "servers": {
    "mermaid-mcp": {
      "type": "http",
      "url": "https://mcp.mermaidchart.com/mcp"
    }
  }
}
{
  "mcpServers": {
    "mermaid-mcp": {
      "httpUrl": "https://mcp.mermaidchart.com/mcp"
    }
  }
}
extensions:
  "mermaid-mcp":
    enabled: true
    name: "mermaid-mcp"
    type: streamable_http
    uri: "https://mcp.mermaidchart.com/mcp"
    timeout: 300

Quality 89 / 100good

protocoln/a · weight 25
  • n/a
    protocol.modern, protocol.stateless, protocol.transport, protocol.list_ttlno remote answered a protocol handshake (not probed yet, unreachable, or local-only)
authorization83 · weight 15
  • pass
    auth.prmProtected Resource Metadata (RFC 9728) published
  • pass
    auth.as_metadataauthorization server metadata reachable
  • warn
    auth.cimdonly Dynamic Client Registration, deprecated in 2026-07-28 in favour of CIMD
  • n/a
    auth.secret_in_urlno templated URL
tool hygiene86 · weight 30
  • pass
    tools.descriptionsevery tool has a description
  • pass
    tools.description_lengthdescriptions are concise
  • pass
    tools.schemasevery tool has an object input schema
  • pass
    tools.annotations25 of 25 tools declare readOnlyHint or destructiveHint
  • fail
    tools.directory_hintsno tool declares all four of readOnlyHint, destructiveHint, idempotentHint and openWorldHint; missing: validate_and_render_mermaid_diagram (destructiveHint, idempotentHint, openWorldHint); create_pr (destructiveHint, idempotentHint, openWorldHint); list_pulls (destructiveHint, idempotentHint, openWorldHint); …
  • pass
    tools.token_costabout 5,580 tokens to load every tool
  • pass
    tools.api_dumptools are not a one-to-one API dump
stability100 · weight 15
  • pass
    stability.changesno tool changes in 30 days
  • pass
    stability.rug_pullno tool changed its meaning under the same name
dependenciesn/a · weight 15
  • n/a
    deps.known_vulns, deps.mcp_sdk_version, deps.resolvableno npm or PyPI package

25 tools, about 5,580 tokens to load them all · tool set 37c6e245f217 · checked 2026-10-09 23:53 UTC

Tool changes

No tool definition changes recorded. A server's first observation is its baseline; later probes record what changes.

Checks run on what our credential-free, read-only probes observe; tools are never called and no code audit is performed. How it is computed.

Trust 78 / 100

provenance75
liveness100
freshness25
hygiene100

+repository +dns-namespace +reachable +uptime-100% -stale-387d

Derived from observable signals (official registry feed and our own credential-free probes); no code audit performed. How it is computed.

Endpoints

remoteauthreachableuptime 30dp50protocollast ok
https://mcp.mermaidchart.com/mcp streamable-httpoauth2 AS: https://ummcsnegloedxcrwlucz.supabase.co/auth/v1yes100%622 ms–2026-10-09
https://mcp.mermaidchart.com/sse sseoauth2 AS: https://ummcsnegloedxcrwlucz.supabase.co/auth/v1yes100%621 ms–2026-10-09

Tools (25)

create_issueCreate an issue in a GitHub repository. REQUIRES: `Github-Token` (HTTP) or GITHUB_TOKEN with issues write if creating issues in private repos.
create_prCreate 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).
generate_jira_kanban_boardread-onlyGenerate 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_treeread-onlyGenerate 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_diagramread-onlyGenerate 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_timelineread-onlyGenerate 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.
get_diagram_summaryread-onlyGenerate 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_titleread-onlyGenerate a descriptive title for a Mermaid diagram based on its content. This tool analyzes the diagram structure and content to suggest an appropriate title.
get_issue_commentsread-onlyList comments on an issue by issue number. REQUIRES: `Github-Token` (HTTP) or GITHUB_TOKEN / GH_TOKEN.
get_mermaid_syntax_documentread-onlyGet 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.
get_notion_mermaid_diagram_by_block_idread-onlyRetrieve a single Mermaid diagram block by its block ID. Returns the diagram code and optional caption.
get_notion_page_mermaid_diagramsread-onlyExtract all Mermaid code blocks from a Notion page. Returns block ID, diagram code, and optional caption for each block.
get_pull_commentsread-onlyGet 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.
insert_notion_mermaid_diagramAppend a Mermaid diagram as a code block to a Notion page. The block is added at the end of the page content.
list_branchesread-onlyList 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.
list_issuesread-onlyList issues for a repository (excludes pull requests). REQUIRES: `Github-Token` (HTTP) or GITHUB_TOKEN / GH_TOKEN.
list_mermaid_filesread-onlyList .mmd Mermaid files in a GitHub repository (code search with tree fallback). REQUIRES: `Github-Token` header (HTTP) or GITHUB_TOKEN / GH_TOKEN.
list_pullsread-onlyList pull requests for a GitHub repository. REQUIRES: `Github-Token` (HTTP) or GITHUB_TOKEN / GH_TOKEN.
list_reposread-onlyList 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.
list_toolsread-onlyLists all available MCP servers and their tools in the workspace.
push_fileCreate or update a single file on a given branch in a GitHub repository. REQUIRES: `Github-Token` (HTTP) or GITHUB_TOKEN with contents write access.
read_mermaid_fileread-onlyRead 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_iconsread-onlySearch 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.
update_notion_mermaid_diagramUpdate the Mermaid source code (and optional caption) of an existing mermaid code block by its block ID.
validate_and_render_mermaid_diagramread-onlySIMPLE 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.

Schemas: list_tools.

Official server.json
{
  "name": "com.mermaidchart/mermaid-mcp",
  "$schema": "https://static.modelcontextprotocol.io/schemas/2025-09-29/server.schema.json",
  "remotes": [
    {
      "url": "https://mcp.mermaidchart.com/mcp",
      "type": "streamable-http"
    },
    {
      "url": "https://mcp.mermaidchart.com/sse",
      "type": "sse"
    }
  ],
  "version": "1.0.0",
  "repository": {
    "url": "https://github.com/Mermaid-Chart/mermaid-mcp",
    "source": "github"
  },
  "description": "MCP server for Mermaid diagram validation and rendering"
}