# mermaid-mcp MCP server

MCP server for Mermaid diagram validation and rendering

## Links
- Registry page: https://www.getdrio.com/mcp/com-mermaidchart-mermaid-mcp
- Repository: https://github.com/Mermaid-Chart/mermaid-mcp

## Install
- Endpoint: https://mcp.mermaidchart.com/mcp
- Auth: Not captured

## Setup notes
- Remote endpoint: https://mcp.mermaidchart.com/mcp
- Remote endpoint: https://mcp.mermaidchart.com/sse

## Tools
- 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. Endpoint: https://mcp.mermaidchart.com/mcp
- 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. Endpoint: https://mcp.mermaidchart.com/mcp
- 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. Endpoint: https://mcp.mermaidchart.com/mcp
- 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. Endpoint: https://mcp.mermaidchart.com/mcp
- 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. Endpoint: https://mcp.mermaidchart.com/mcp
- list_tools - Lists all available MCP servers and their tools in the workspace. Endpoint: https://mcp.mermaidchart.com/mcp
- 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. Endpoint: https://mcp.mermaidchart.com/mcp
- 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. Endpoint: https://mcp.mermaidchart.com/mcp
- 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. Endpoint: https://mcp.mermaidchart.com/mcp
- 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). Endpoint: https://mcp.mermaidchart.com/mcp
- 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. Endpoint: https://mcp.mermaidchart.com/mcp
- list_pulls - List pull requests for a GitHub repository. REQUIRES: `Github-Token` (HTTP) or GITHUB_TOKEN / GH_TOKEN. Endpoint: https://mcp.mermaidchart.com/mcp
- 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. Endpoint: https://mcp.mermaidchart.com/mcp
- list_issues - List issues for a repository (excludes pull requests). REQUIRES: `Github-Token` (HTTP) or GITHUB_TOKEN / GH_TOKEN. Endpoint: https://mcp.mermaidchart.com/mcp
- 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. Endpoint: https://mcp.mermaidchart.com/mcp
- get_issue_comments - List comments on an issue by issue number. REQUIRES: `Github-Token` (HTTP) or GITHUB_TOKEN / GH_TOKEN. Endpoint: https://mcp.mermaidchart.com/mcp
- 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. Endpoint: https://mcp.mermaidchart.com/mcp
- 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. Endpoint: https://mcp.mermaidchart.com/mcp
- 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. Endpoint: https://mcp.mermaidchart.com/mcp
- 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. Endpoint: https://mcp.mermaidchart.com/mcp
- 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. Endpoint: https://mcp.mermaidchart.com/mcp
- 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. Endpoint: https://mcp.mermaidchart.com/mcp
- get_notion_mermaid_diagram_by_block_id - Retrieve a single Mermaid diagram block by its block ID. Returns the diagram code and optional caption. Endpoint: https://mcp.mermaidchart.com/mcp
- update_notion_mermaid_diagram - Update the Mermaid source code (and optional caption) of an existing mermaid code block by its block ID. Endpoint: https://mcp.mermaidchart.com/mcp
- 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. Endpoint: https://mcp.mermaidchart.com/mcp

## Resources
Not captured

## Prompts
Not captured

## Metadata
- Owner: com.mermaidchart
- Version: 1.0.0
- Runtime: Sse, Streamable Http
- Transports: HTTP
- License: Not captured
- Language: Not captured
- Stars: Not captured
- Updated: Sep 18, 2025
- Source: https://registry.modelcontextprotocol.io