{"name":"Mermaid MCP Server","version":"eea619cdcdf4d141c4d4d19719e87c520b51f167","description":"Professional Mermaid diagram validation and rendering server with comprehensive Mermaid Chart integration","author":"Prashant Suryawanshi","license":"MIT","endpoints":{"http":{"url":"http://mcp.mermaid.ai/mcp","transport":"http","description":"Standard MCP HTTP transport"},"sse":{"url":"http://mcp.mermaid.ai/sse","transport":"sse","description":"Server-Sent Events transport for real-time updates"},"messages":{"url":"http://mcp.mermaid.ai/messages","method":"POST","description":"SSE transport: JSON-RPC messages after connecting via GET /sse"},"paths":{"mcp_discovery":"/.well-known/mcp","root_info":"/","http_post":"/mcp","http_get":"/mcp","sse_connect":"/sse","sse_messages":"/messages","health":"/health"}},"notes":["GET /, GET /.well-known/mcp, and GET /health are public metadata or health; they do not replace the MCP protocol.","Streamable HTTP: POST /mcp carries JSON-RPC. GET /mcp is for an existing session only (requires Mcp-Session-Id from initialize), not for this discovery JSON.","SSE mode: GET /sse opens the stream; POST /messages sends JSON-RPC. Hybrid deployments expose both HTTP and SSE paths; HTTP-only or SSE-only processes may omit the other transport's routes."],"authentication":{"required":true,"type":"OAuth 2.1","discover_url":"http://mcp.mermaid.ai/.well-known/oauth-authorization-server"},"serverInfo":{"name":"mcp-mermaid-hybrid","version":"1.0.0"},"instructions":"You are connected to the comprehensive Mermaid MCP server with powerful capabilities:\n\n PRIMARY WORKFLOW: Use validate_and_render_mermaid_diagram for all diagram creation and validation.\n\n DIAGRAM MANAGEMENT: This server connects to your Mermaid Chart account providing full CRUD operations:\n   • Create, read, update, delete diagrams directly from your LLM\n   • List and browse your Chart projects and diagrams\n   • Sync diagrams between local rendering and cloud storage\n\n RENDERING & VALIDATION: Advanced diagram processing tools:\n   • Validate syntax and render diagrams as PNG/SVG with live editor links\n   • AI-powered diagram repair using Mermaid Chart's AI (consumes credits)\n   • Support for all Mermaid diagram types with comprehensive validation\n\n UTILITY TOOLS: Enhanced diagram creation assistance:\n   • Search AWS/Azure/GCP/FontAwesome icons for architecture diagrams\n   • Get comprehensive syntax documentation for any diagram type\n   • AI-generated titles and summaries for documentation\n\n AUTHENTICATION: AUTH: Without a token the user gets 6 tools. With a Mermaid Chart API token they unlock full diagram management (create, update, delete, repair). If a tool returns a 401, instruct the user to add their token.\n","quickstart":{"description":"Add this MCP server configuration to your AI client:","vscode":{"description":"VS Code (with GitHub Copilot or other MCP extensions)","http_with_auth":{"servers":{"mermaid-mcp":{"url":"http://mcp.mermaid.ai/mcp","type":"http","headers":{"Authorization":"YOUR_MERMAID_CHART_TOKEN_HERE"}}}}},"cursor":{"description":"Cursor IDE","http_with_auth":{"mcpServers":{"mermaid-mcp":{"transport":"http","url":"http://mcp.mermaid.ai/mcp","headers":{"Authorization":"YOUR_MERMAID_CHART_TOKEN_HERE"}}}}},"antigravity":{"description":"Antigravity IDE (requires Node.js and mcp-remote)","prerequisites":"npm install -g mcp-remote","remote_proxy":{"mcpServers":{"mermaid":{"command":"npx","args":["-y","mcp-remote","--header","Authorization:YOUR_MERMAID_CHART_TOKEN_HERE","http://mcp.mermaid.ai/mcp"]}}}},"claude_desktop":{"description":"Claude Desktop (using claude CLI)","command":"claude mcp add --transport http mermaid-mcp http://mcp.mermaid.ai/mcp --header \"Authorization: Bearer YOUR_MERMAID_CHART_TOKEN_HERE\""},"setup_instructions":["To use Mermaid Chart integration features:","1. Login to your Mermaid Chart account","2. Go to Settings → API Tokens","3. Generate a new token","4. Replace YOUR_MERMAID_CHART_TOKEN_HERE with your token","5. Restart your MCP client","Note: Without authentication, you get 6 helper tools. With auth, you unlock full diagram management capabilities."]},"transport":{"type":"streamable-http","endpoint":"/mcp","alternatives":{"http":"http://mcp.mermaid.ai/mcp","sse":"http://mcp.mermaid.ai/sse"}},"authorization":{"enabled":true,"type":"OAuth 2.1","auth_server_url":"https://mermaid.ai/.well-known/oauth-authorization-server","description":"OAuth authentication required for Chart integration features. Your MCP client will handle this automatically."},"capabilities":{"tools":true,"resources":false,"prompts":false,"sampling":false},"tools":[{"name":"validate_and_render_mermaid_diagram","description":"Validate and render a Mermaid diagram as PNG/SVG with live editor link","requiresAuth":false,"annotations":{"category":"diagram-validation-rendering","cost":"medium","examples":["Create any type of Mermaid diagram","Validate syntax and generate visual output","Get live editor links for further editing"],"when_to_use":"Primary tool for all diagram creation, validation, and rendering","when_not_to_use":"When you only need syntax documentation without rendering"}},{"name":"get_diagram_title","description":"Generates a short, professional title for a Mermaid diagram.\n          Call after validate_and_render_mermaid_diagram when saving to Mermaid Chart or writing documentation.","requiresAuth":false,"annotations":{"category":"content-generation","cost":"low","examples":["Generate descriptive titles for any diagram type","Create meaningful names for complex workflows"],"when_to_use":"When diagrams need descriptive or professional titles","when_not_to_use":"For diagrams that already have appropriate titles"}},{"name":"get_diagram_summary","description":"Generate concise summaries for Mermaid diagrams","requiresAuth":false,"annotations":{"category":"content-generation","cost":"low","examples":["Generate concise explanations of diagram logic","Create documentation summaries for complex diagrams"],"when_to_use":"For documentation or when diagrams need explanatory text","when_not_to_use":"For simple diagrams that are self-explanatory"}},{"name":"search_mermaid_icons","description":"Search for AWS, Azure, GCP, and FontAwesome icons for diagrams","requiresAuth":false,"annotations":{"category":"icon-enhancement","cost":"low","examples":["Find cloud provider icons for architecture diagrams","Search for technical component icons","Get FontAwesome icons for general use"],"when_to_use":"When enhancing diagrams with professional icons","when_not_to_use":"For text-only diagrams or simple flowcharts"}},{"name":"get_mermaid_syntax_document","description":"Get comprehensive syntax documentation for any Mermaid diagram type","requiresAuth":false,"annotations":{"category":"documentation-help","cost":"low","examples":["Get comprehensive syntax reference for any diagram type","Learn proper formatting and structure rules","Explore supported features and options"],"when_to_use":"When learning new diagram types or need syntax reference","when_not_to_use":"When already familiar with the diagram syntax"}},{"name":"list_mermaid_chart_projects","description":"Lists all Mermaid Chart projects in the authenticated user's account. \n           Always call this before create_mermaid_chart_diagram to obtain a valid project_id.","requiresAuth":true,"annotations":{"category":"diagram-management","cost":"low","examples":["Browse your Mermaid Chart projects","Find appropriate project for new diagrams"],"when_to_use":"Before creating or organizing diagrams in Mermaid Chart","when_not_to_use":"When working with local diagrams only"}},{"name":"list_mermaid_chart_diagrams","description":"List diagrams in a specific Mermaid Chart project","requiresAuth":true,"annotations":{"category":"diagram-management","cost":"low","examples":["Browse diagrams within a specific project","Find existing diagrams for updates or reference"],"when_to_use":"To explore or manage diagrams within a project","when_not_to_use":"When creating brand new diagrams"}},{"name":"create_mermaid_chart_diagram","description":"Create a new diagram in Mermaid Chart","requiresAuth":true,"annotations":{"category":"diagram-management","cost":"medium","examples":["Save validated diagrams to your Mermaid Chart account","Create cloud-stored diagrams with shareable links"],"when_to_use":"After validating diagrams and choosing target project","when_not_to_use":"Before diagram validation or without selecting project"}},{"name":"get_mermaid_chart_diagram","description":"Retrieve a diagram from Mermaid Chart","requiresAuth":true,"annotations":{"category":"diagram-management","cost":"low","examples":["Retrieve saved diagrams from your account","Get diagram content for modification or reference"],"when_to_use":"To access and work with existing Mermaid Chart diagrams","when_not_to_use":"When creating completely new diagrams"}},{"name":"update_mermaid_chart_diagram","description":"Update an existing diagram in Mermaid Chart","requiresAuth":true,"annotations":{"category":"diagram-management","cost":"medium","examples":["Update existing diagrams with new content","Modify saved diagrams with improvements or fixes"],"when_to_use":"To modify and save changes to existing Mermaid Chart diagrams","when_not_to_use":"When creating new diagrams or working locally only"}},{"name":"repair_mermaid_chart_diagram","description":"Repair a broken Mermaid diagram using AI","requiresAuth":true,"annotations":{"category":"ai-repair-tool","cost":"high","examples":["Fix complex syntax errors using AI assistance","Repair malformed diagrams that are difficult to debug manually"],"when_to_use":"When diagrams have complex errors requiring AI analysis (consumes credits)","when_not_to_use":"For simple errors or when credits need to be conserved"}},{"name":"list_tools","description":"List all available MCP tools and their workflows","requiresAuth":false,"annotations":{"category":"utility-tools","cost":"low","examples":["Explore all available server capabilities","Check tool availability and authentication status"],"when_to_use":"To discover server capabilities and available tools","when_not_to_use":"When already familiar with all server functionality"}}],"toolCategories":{"diagram-validation-rendering":"Core diagram validation and rendering - the primary tools for creating, validating, and generating visual output for Mermaid diagrams with live editor integration","diagram-management":"Mermaid Chart integration tools - full CRUD operations to create, read, update, and delete diagrams directly in your Mermaid Chart account from your LLM interface","ai-repair-tool":"Advanced AI-powered diagram repair - uses Mermaid Chart's AI service to automatically fix complex syntax errors and malformed diagrams (consumes user credits for accuracy)","content-generation":"AI-powered content creation - generates professional titles and comprehensive summaries for diagrams to enhance documentation and presentation quality","icon-enhancement":"Professional icon integration - search and integrate AWS, Azure, GCP, and FontAwesome icons to create visually appealing architecture and technical diagrams","documentation-help":"Comprehensive syntax reference - access official Mermaid documentation and examples for all diagram types to learn proper syntax and explore advanced features","utility-tools":"Server introspection and management - tools to explore server capabilities, check authentication status, and understand available functionality"}}