# Mermaid Chart MCP MCP Server

> **Mermaid Chart MCP MCP Server** is a hosted, multitenant Model Context Protocol (MCP) server run by **MewCP** (https://mewcp.com), giving AI agents managed access to Mermaid Chart MCP.
>
> MewCP takes care of all MCP infrastructure for you — credential storage, OAuth flows,
> token refresh, and production-grade auto-scaling — so your AI agents can connect to
> third-party services and run freely without you managing any MCP server yourself.
>
> Server page:  https://mewcp.com/mcp/mermaid-chart-mcp
> MewCP docs:   https://docs.mewcp.com
> All servers:  https://mewcp.com/servers (JSON: https://mewcp.com/api/servers)
> About MewCP:  https://mewcp.com/llms.txt

---

## About

Enable AI assistants to create, validate, and render Mermaid diagrams seamlessly, plus full integration with your Mermaid Chart account for advanced diagram management.

---

## Details

- Server ID: `mermaid-chart-mcp`
- Version: 1.0.0
- Tools: 34
- Authentication: API key, held by MewCP
- Transport: http

---

## Access

The gateway URL below serves your **entire MewCP toolset**, not this server on its
own. Pasting a config snippet is not enough — Mermaid Chart MCP has to be in the toolset
first. In order:

1. Add Mermaid Chart MCP to your toolset at https://mewcp.com/mcp/mermaid-chart-mcp
2. Connect your Mermaid Chart MCP account (API key); MewCP stores the credential and attaches it to each call
3. Add the gateway URL to your client (see Connect below). It signs in with OAuth
   the first time it connects, so there is no key to copy.

Once connected, an agent does **not** see this server's tools as top-level tools.
It sees four meta-tools and reaches everything through them:

- `search(query)` — find tools by keyword across the toolset
- `get_schema(tools)` — full description and arguments for the tools you picked
- `list_accounts(provider)` — only when one app has several connected accounts
- `call_tool(server_maskedId, tool_name, args)` — execute

So the list below is what `search` can return for this server, not a set of
callable tool names on their own.

---

## Tools (34)

Descriptions are truncated to 160 characters; call `get_schema`
for the full text and the argument schema. Where a tool is annotated, its type
is shown — treat `destructive` as irreversible.

- `validate_and_render_mermaid_diagram` _(read)_ — SIMPLE RENDER TOOL - Renders Mermaid diagrams directly (Mermaid automatically validates during rendering). If successful, returns diagram image. If Mermaid…
- `get_diagram_title` _(read)_ — 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.
- `get_diagram_summary` _(read)_ — 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)…
- `search_mermaid_icons` _(read)_ — 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…
- `get_mermaid_syntax_document` _(read)_ — Get comprehensive syntax documentation and examples for a specific Mermaid diagram type. Returns the official Mermaid.js documentation with syntax rules,…
- `list_tools` _(read)_ — Lists all available MCP servers and their tools in the workspace.
- `list_mermaid_chart_projects` _(read)_ — List all projects in your Mermaid Chart account. REQUIRES OAUTH AUTHENTICATION: MCP client will handle authentication automatically via Mermaid Chart OAuth.
- `list_mermaid_chart_diagrams` _(read)_ — List all diagrams in a specific Mermaid Chart project. REQUIRES OAUTH AUTHENTICATION: MCP client handles authentication automatically.
- `create_mermaid_chart_diagram` _(write)_ — Create a new diagram in Mermaid Chart. REQUIRES OAUTH AUTHENTICATION: MCP client handles authentication automatically. Use list_mermaid_chart_projects to get…
- `get_mermaid_chart_diagram` _(read)_ — Get a diagram from Mermaid Chart by its document ID. REQUIRES AUTHENTICATION: Use authenticate_mermaid_chart first.
- `update_mermaid_chart_diagram` _(write)_ — Update an existing diagram in Mermaid Chart. REQUIRES AUTHENTICATION: Use authenticate_mermaid_chart first.
- `repair_mermaid_chart_diagram` _(write)_ — Repair a broken Mermaid diagram using Mermaid AI. Requires authentication. Use this tool when you have a Mermaid diagram with syntax errors or rendering issues.
- `chat_with_mermaid_ai` _(write)_ — Chat with Mermaid AI to create, modify, or discuss Mermaid diagrams in natural language. Requires authentication. The AI understands your diagram context and…
- `get_ai_credits_usage` _(read)_ — Get AI credits usage information. Shows remaining and total credits for AI-powered features like diagram repair.
- `mermaid_pr_summary` _(write)_ — Suggest a pull request title and body (markdown) from the diff between two Mermaid diagram versions (Mermaid AI diagram-diff-summary). Requires authentication.…
- `list_repos` _(read)_ — List GitHub repositories for the authenticated user, or for an organization when `org` is set. REQUIRES: `Github-Token` header (HTTP) or `GITHUB_TOKEN` /…
- `list_mermaid_files` _(read)_ — 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)_ — 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.
- `create_pr` _(write)_ — 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`…
- `push_file` _(write)_ — 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.
- `list_pulls` _(read)_ — List pull requests for a GitHub repository. REQUIRES: `Github-Token` (HTTP) or GITHUB_TOKEN / GH_TOKEN.
- `list_branches` _(read)_ — 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;…
- `list_issues` _(read)_ — List issues for a repository (excludes pull requests). REQUIRES: `Github-Token` (HTTP) or GITHUB_TOKEN / GH_TOKEN.
- `create_issue` _(write)_ — 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` _(read)_ — List comments on an issue by issue number. REQUIRES: `Github-Token` (HTTP) or GITHUB_TOKEN / GH_TOKEN.
- `get_pull_comments` _(read)_ — 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:…
- `generate_ticket_dependency_tree` _(read)_ — 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…
- `generate_jira_kanban_board` _(read)_ — 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 →…
- `generate_ticket_diagram` _(read)_ — 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…
- `generate_ticket_timeline` _(read)_ — Generate a Mermaid diagram showing the history of a single Jira ticket using its changelog. Two views are available: - **state**: stateDiagram-v2 showing all…
- `get_notion_page_mermaid_diagrams` _(read)_ — Extract all Mermaid code blocks from a Notion page. Returns block ID, diagram code, and optional caption for each block.
- `get_notion_mermaid_diagram_by_block_id` _(read)_ — Retrieve a single Mermaid diagram block by its block ID. Returns the diagram code and optional caption.
- `update_notion_mermaid_diagram` _(write)_ — Update the Mermaid source code (and optional caption) of an existing mermaid code block by its block ID.
- `insert_notion_mermaid_diagram` _(write)_ — Append a Mermaid diagram as a code block to a Notion page. The block is added at the end of the page content.

---

## Connect

- URL: https://gateway.mewcp.com/personal/mcp
- Transport: Streamable HTTP (remote). Nothing to install.
- Sign-in: OAuth. On first connect the client opens a browser window to sign in
  to MewCP and approve access. No API key.
- Headless clients (SDKs, servers without a browser) send an API key instead:
  `Authorization: Bearer <API_KEY>`, key from https://mewcp.com/dashboard/api-keys

Agents setting themselves up: follow https://mewcp.com/SKILL.md

Step-by-step guide per client:

- Claude Desktop: https://mewcp.com/mcp/mermaid-chart-mcp/connect/claude
- ChatGPT: https://mewcp.com/mcp/mermaid-chart-mcp/connect/chatgpt
- VS Code: https://mewcp.com/mcp/mermaid-chart-mcp/connect/vscode
- Cursor: https://mewcp.com/mcp/mermaid-chart-mcp/connect/cursor
- Codex: https://mewcp.com/mcp/mermaid-chart-mcp/connect/codex
- Claude Code: https://mewcp.com/mcp/mermaid-chart-mcp/connect/claude-code
- OpenCode: https://mewcp.com/mcp/mermaid-chart-mcp/connect/opencode
- OpenClaw: https://mewcp.com/mcp/mermaid-chart-mcp/connect/openclaw
- Antigravity: https://mewcp.com/mcp/mermaid-chart-mcp/connect/antigravity
- Hermes: https://mewcp.com/mcp/mermaid-chart-mcp/connect/hermes
- DeepSeek Harness: https://mewcp.com/mcp/mermaid-chart-mcp/connect/dsh
- Python: https://mewcp.com/mcp/mermaid-chart-mcp/connect/python
- TypeScript: https://mewcp.com/mcp/mermaid-chart-mcp/connect/typescript