{ "data": { "a": { "slug": "diagrams-so", "name": "Diagrams.so API + MCP", "vendor": "Diagrams.so (RedHold LLC)", "vendorUrl": "https://diagrams.so", "kind": "http-api", "category": "diagramming", "summary": "Turns a plain-English description into an editable draw.io diagram with cloud icons (AWS, Azure, GCP, OCI, Kubernetes).", "url": "https://www.anchorterminal.com/tools/diagrams-so", "markdownUrl": "https://www.anchorterminal.com/tools/diagrams-so.md", "slimMarkdownUrl": "https://www.anchorterminal.com/tools/diagrams-so.min.md", "jsonUrl": "https://www.anchorterminal.com/api/v1/tools/diagrams-so.json", "repo": "https://github.com/RedHold/diagrams-sdk", "license": "Apache-2.0", "transports": [ "http", "stdio" ], "remoteUrl": "https://api.diagrams.so/api/v2", "packages": [ { "registry": "npm", "name": "@diagrams-so/mcp" }, { "registry": "npm", "name": "@diagrams-so/sdk" }, { "registry": "pypi", "name": "diagrams-so" } ], "auth": "mixed", "authNotes": "API keys (dgz_live_ and dgz_test_) as a Bearer header, revocable at once, with a cap of 25 active keys. Test keys spend real credits. The MCP server and SDKs can instead log in through a device flow (npx @diagrams-so/mcp@latest login), where the one-time code is emailed (set DIAGRAMS_LOGIN_EMAIL for the in-chat path) and the credential is cached at ~/.diagrams-so/credentials.json. DIAGRAMS_API_KEY works for CI.", "pricing": "freemium", "pricingNotes": "Free $0 with 10 one-time credits, no card, public diagrams and watermarked exports. Pro $15 a month or $10 a month billed yearly (75 credits a month), Power $25 a month or $16.67 billed yearly (250 credits). Credit packs $5 per 25. API, MCP and SDKs are on every plan and use the same credits as the app. Reads, exports and prompt helpers are free. Per-action credit costs are shown in the app; the SDK changelog gives 0.5 to 3.0 credits for generate, edit, fix and re-layout. A bring-your-own LLM key skips plan credits. 14-day money-back guarantee on the first paid subscription (https://diagrams.so/pricing).", "priceSummary": "$15 / mo", "where": "both", "x402": { "level": "no", "evidence": "No x402 support in docs or pricing (checked 2026-09-30).", "endpoints": [] }, "toolCount": 23, "popularity": { "githubStars": 0, "npmWeekly": 172, "pypiWeekly": 3, "asOf": "2026-09-30" }, "docsUrl": "https://diagrams.so/developers", "llmsTxt": "https://diagrams.so/llms.txt", "openapi": "https://api.diagrams.so/api/v2/openapi.json", "registryName": "io.github.RedHold/diagrams-so-mcp", "capabilities": [ "diagram.create", "diagram.edit", "diagram.export", "diagram.architecture" ], "tags": [ "hosted", "freemium", "free-tier", "mcp", "llms-txt", "openapi", "python", "typescript" ], "lastRelease": "2026-08-19", "graded": true, "anchor": { "graded": true, "score": 60.1, "grade": "C", "agentReady": false, "rank": 255, "ranked": true, "rankOf": 452, "categoryRank": 5, "methodology": "0.3", "run": "2026-10-01", "scores": { "ergonomics": 85, "maintenance": 71, "payments": 32, "reliability": 30, "schema": 85, "security": 67, "transparency": 75 }, "pending": [ "performance", "tasks" ], "assessment": { "confidence": "medium", "date": "2026-10-01" }, "negative": -2, "negativeNotes": [ "Early August 2026. The API moved its device login to an emailed code without notice, which broke the MCP server's in-chat connect path and sent one rejected request per tool call until v1.4.6 fixed it on 19 August. Fixed and documented in the server's changelog, so the deduction is reduced (https://github.com/RedHold/diagrams-mcp-app-core/blob/main/CHANGELOG.md)." ], "verdict": "API, MCP and SDKs on every plan, including a Free plan marked \"No Card Required\". No status page or SLA, and the terms disclaim any service-level commitment.", "strengths": [ "API, MCP and SDKs on every plan, including a Free plan marked \"No Card Required\"", "OpenAPI 3.1 with 32 operations, and an Idempotency-Key on every billable call", "All 23 MCP tools carry readOnlyHint or destructiveHint annotations", "Editable draw.io XML output with Well-Architected warnings and a fix tool", "Terms promise 90 days' notice before a major API version is retired" ], "weaknesses": [ "No status page or SLA, and the terms disclaim any service-level commitment", "Rate limits exist per key and per IP but no numbers are published", "Per-action credit costs are shown only in the app", "Domain registered in February 2026, and no commits to either repo since 19 August 2026", "Login is a device flow a person must approve by email, so there's no autonomous signup" ], "agentNotes": [ "Send an Idempotency-Key on generate, edit, fix and re-layout. If a billable call times out, check `get_usage_history` before retrying", "Generation is synchronous and can run for minutes. The SDKs default to a 450 s timeout, or use `POST /diagrams/stream`", "Call `list_capabilities` first. `cloud_provider` and `diagram_type` are free strings, and a wrong value fails the call", "`relayout_diagram` refuses to run without `confirm=true`, because every re-layout is billed", "Test keys (dgz_test_) spend the same credits as live keys" ], "metrics": { "kind": "remote", "measured": false }, "reviewCount": 2, "avgRating": 4, "history": [ { "basis": "public evidence", "confidence": "medium", "grade": "C", "methodology": "0.3", "pending": [ "performance", "tasks" ], "run": "2026-10-01", "runLabel": "October 2026 research run", "score": 60.1 } ], "editorialScores": { "ergonomics": 85, "maintenance": 71, "payments": 32, "reliability": 30, "schema": 85, "security": 67, "transparency": 75 }, "provenanceScore": 75 }, "connect": { "http": "curl https://api.diagrams.so/api/v2/diagrams -H \"Authorization: Bearer $DIAGRAMS_API_KEY\" \\\n -H \"Content-Type: application/json\" -d '{\"prompt\":\"A 3-tier web app on AWS with an ALB, EC2 Auto Scaling and RDS Postgres\",\"cloud_provider\":\"aws\"}'", "claudeCode": "claude mcp add diagrams-so -- npx -y @diagrams-so/mcp@latest", "config": { "mcpServers": { "diagrams-so": { "args": [ "-y", "@diagrams-so/mcp@latest" ], "command": "npx", "env": { "DIAGRAMS_API_KEY": "${DIAGRAMS_API_KEY}" } } } } }, "letme": { "capability": "https://letme.dev/diagram.create", "tool": "https://letme.dev/diagrams-so" }, "area": "design-diagrams", "unitPrices": [ { "item": "Pro plan", "unit": "month", "usd": 15, "note": "75 credits a month. $10 a month billed yearly" }, { "item": "Power plan", "unit": "month", "usd": 25, "note": "250 credits a month. $16.67 a month billed yearly" }, { "item": "Credit pack", "unit": "credit", "usd": 0.2, "note": "$5 per 25 credits, pack credits don't expire" } ], "provenance": { "legalEntity": "RedHold LLC", "domain": "diagrams.so", "domainRegistered": "2026-02-05", "endpointOnVendorDomain": true, "terms": "https://diagrams.so/policy/terms", "privacy": "https://diagrams.so/policy/privacy", "statusPage": "", "changelog": "https://diagrams.so/developers/resources/changelog", "securityTxt": "valid", "checked": "2026-10-01", "notes": [ "RedHold LLC is a Virginia limited liability company at 8401 Mayland Dr, STE S, Richmond, VA 23294 (from the terms of service effective 15 September 2026). We couldn't load a state registry record to confirm it independently", "The status and SLA page says a status page will be linked once it is live", "security.txt not rechecked on 2026-10-01; valid per the 30 September check" ], "score": 75 }, "pageJsonUrl": "https://www.anchorterminal.com/tools/diagrams-so.json", "live": { "slug": "diagrams-so", "probe": { "target": "https://api.diagrams.so/api/v2", "method": "get", "lastAt": "2026-10-04T23:48:07.536692053Z", "lastOk": true, "lastStatus": 404, "lastMs": 340, "authRequired": false, "uptime24h": 97.06, "uptime30d": 97, "p50ms24h": 345, "p95ms24h": 405, "samples24h": 272, "samples30d": 1100, "days": [ { "date": "2026-09-30", "probes": 35, "ok": 33 }, { "date": "2026-10-01", "probes": 276, "ok": 268 }, { "date": "2026-10-02", "probes": 248, "ok": 240 }, { "date": "2026-10-03", "probes": 271, "ok": 264 }, { "date": "2026-10-04", "probes": 270, "ok": 262 } ] }, "versions": [ { "registry": "mcp-registry", "name": "io.github.RedHold/diagrams-so-mcp", "version": "1.4.6", "seenAt": "2026-10-04T23:42:40.113054682Z" }, { "registry": "npm", "name": "@diagrams-so/mcp", "version": "1.4.6", "seenAt": "2026-10-04T16:25:36.673190162Z" }, { "registry": "npm", "name": "@diagrams-so/sdk", "version": "1.3.0", "seenAt": "2026-10-04T16:25:37.522112948Z" }, { "registry": "pypi", "name": "diagrams-so", "version": "1.3.0", "released": "2026-08-05", "seenAt": "2026-10-04T16:25:38.902347471Z" } ], "githubStars": 0, "npmWeekly": 91, "pypiWeekly": 4, "securityTxt": { "url": "https://diagrams.so/.well-known/security.txt", "state": "valid", "expires": "2027-08-01T00:00:00Z", "checkedAt": "2026-10-04T15:16:00.348168997Z" }, "llmsTxt": { "url": "https://diagrams.so/llms.txt", "ok": true, "status": 200, "checkedAt": "2026-10-04T15:17:30.857189856Z" }, "domain": { "domain": "diagrams.so", "checkedAt": "2026-10-04T13:04:27.501679981Z" }, "pages": [ { "url": "https://diagrams.so/developers/resources/changelog", "kind": "changelog", "status": 304, "checkedAt": "2026-10-04T15:43:04.874729172Z", "changedAt": "0001-01-01T00:00:00Z", "fingerprint": "496d4c3074ab" }, { "url": "https://diagrams.so/policy/terms", "kind": "deprecations", "status": 304, "checkedAt": "2026-10-04T15:43:08.963882503Z", "changedAt": "0001-01-01T00:00:00Z", "fingerprint": "862f66aa7b0b" }, { "url": "https://diagrams.so/pricing", "kind": "pricing", "status": 304, "checkedAt": "2026-10-04T15:43:10.965792916Z", "changedAt": "0001-01-01T00:00:00Z", "fingerprint": "ae91841e9c40" }, { "url": "https://diagrams.so/policy/privacy", "kind": "privacy", "status": 304, "checkedAt": "2026-10-04T15:43:06.971241586Z", "changedAt": "0001-01-01T00:00:00Z", "fingerprint": "6fa8d4562829" } ], "updatedAt": "2026-10-04T23:48:07.536692053Z" } }, "b": { "slug": "mermaid-chart", "name": "Mermaid Chart MCP", "vendor": "Mermaid Chart", "vendorUrl": "https://mermaid.ai", "kind": "mcp", "category": "diagramming", "summary": "Hosted MCP server for Mermaid diagrams from mermaid.ai.", "url": "https://www.anchorterminal.com/tools/mermaid-chart", "markdownUrl": "https://www.anchorterminal.com/tools/mermaid-chart.md", "slimMarkdownUrl": "https://www.anchorterminal.com/tools/mermaid-chart.min.md", "jsonUrl": "https://www.anchorterminal.com/api/v1/tools/mermaid-chart.json", "transports": [ "streamable-http", "sse" ], "remoteUrl": "https://mcp.mermaid.ai/mcp", "packages": [ { "registry": "npm", "name": "@mermaidchart/sdk" } ], "auth": "mixed", "authNotes": "Render and validation tools need no auth. Account tools need a Mermaid Chart token generated in account settings and sent as the Authorization header (the docs show the raw token, no Bearer prefix). The TypeScript SDK uses OAuth.", "pricing": "freemium", "pricingNotes": "Basic $0 with 3 diagrams and 15 AI credits. Plus $10 a user a month billed yearly ($12 monthly) with unlimited diagrams and 300 AI credits a year. Premium $20 billed yearly ($24 monthly) with 2,000 AI credits a year and free viewer seats. Enterprise custom. The render tools on the MCP server are free without an account (https://mermaid.ai/pricing).", "priceSummary": "$12 / seat-mo", "where": "hosted", "x402": { "level": "no", "evidence": "No x402 support in docs or pricing (checked 2026-09-30).", "endpoints": [] }, "toolCount": 25, "popularity": { "githubStars": null, "npmWeekly": 395, "pypiWeekly": null, "asOf": "2026-09-30" }, "docsUrl": "https://mermaid.ai/docs/ai/mcp-server", "registryName": "com.mermaidchart/mermaid-mcp", "capabilities": [ "diagram.create", "diagram.as-code", "diagram.edit", "diagram.export" ], "tags": [ "hosted", "freemium", "free-tier", "mcp", "diagram-as-code", "closed-source" ], "lastRelease": "2026-09-17", "graded": true, "anchor": { "graded": true, "score": 31.7, "grade": "F", "agentReady": false, "rank": 442, "ranked": true, "rankOf": 452, "categoryRank": 9, "methodology": "0.3", "run": "2026-10-01", "scores": { "ergonomics": 34, "maintenance": 53, "payments": 45, "reliability": 15, "schema": 32, "security": 20, "transparency": 48 }, "pending": [ "performance", "tasks" ], "assessment": { "confidence": "medium", "date": "2026-10-01" }, "negative": 0, "verdict": "Validation and rendering work with no account or key. Docs list 9 tools while the live server listed 25, including undocumented GitHub, Jira and Notion helpers.", "strengths": [ "Validation and rendering work with no account or key", "Mermaid is plain-text diagram-as-code that renders natively on GitHub and many docs tools", "Hosted, nothing to install, streamable HTTP and SSE", "Official MIT TypeScript SDK, release 0.2.8 on 17 September 2026" ], "weaknesses": [ "Docs list 9 tools while the live server listed 25, including undocumented GitHub, Jira and Notion helpers", "Account tools take a raw token in the Authorization header, with no OAuth or scopes", "No status page, rate limits, changelog, security page or SLA", "Privacy policy last updated September 2024 and names no AI provider", "No public REST API reference, and API access is by application form" ], "agentNotes": [ "Call `validate_and_render_mermaid_diagram` to check syntax before committing Mermaid to a repo. It needs no token", "Only add the token if you need to save into Mermaid Chart projects. It reaches every project on the account", "If you only need a picture, the open-source mermaid-cli renders locally with no network call", "Use mcp.mermaid.ai. The registry still lists the older mcp.mermaidchart.com host" ], "metrics": { "kind": "remote", "measured": false }, "reviewCount": 2, "avgRating": 2.5, "history": [ { "basis": "public evidence", "confidence": "medium", "grade": "F", "methodology": "0.3", "pending": [ "performance", "tasks" ], "run": "2026-10-01", "runLabel": "October 2026 research run", "score": 31.7 } ], "editorialScores": { "ergonomics": 34, "maintenance": 53, "payments": 45, "reliability": 15, "schema": 32, "security": 20, "transparency": 29 }, "provenanceScore": 66 }, "connect": { "claudeCode": "claude mcp add --transport http mermaid https://mcp.mermaid.ai/mcp --header \"Authorization: $MERMAID_CHART_TOKEN\"", "config": { "mcpServers": { "mermaid": { "headers": { "Authorization": "${MERMAID_CHART_TOKEN}" }, "type": "http", "url": "https://mcp.mermaid.ai/mcp" } } } }, "letme": { "capability": "https://letme.dev/diagram.create", "tool": "https://letme.dev/mermaid-chart" }, "area": "design-diagrams", "unitPrices": [ { "item": "Plus plan", "unit": "seat-month", "usd": 12, "note": "billed monthly, $10 billed yearly. 300 AI credits a year" }, { "item": "Premium plan", "unit": "seat-month", "usd": 24, "note": "billed monthly, $20 billed yearly. 2,000 AI credits a year" } ], "provenance": { "legalEntity": "Mermaid Chart Inc.", "domain": "mermaid.ai", "domainRegistered": "2017-12-16", "domainNote": "mermaid.ai was registered in 2017 and transferred on 2025-06-02. The company's earlier domain, mermaidchart.com, was registered on 2022-06-14 and now redirects here.", "endpointOnVendorDomain": true, "terms": "https://mermaid.ai/terms-and-conditions", "privacy": "https://mermaid.ai/web/privacy-policy", "statusPage": "", "changelog": "", "securityTxt": "unknown", "checked": "2026-10-01", "notes": [ "Mermaid Chart Inc., 548 Market Street, PMB 75432, San Francisco, CA 94104-5401 (privacy policy, last updated 13 September 2024)", "The terms are governed by Delaware law and give no postal address", "/.well-known/security.txt and /llms.txt on mermaid.ai returned 401 on 30 September, so neither could be read", "The official MCP registry entry, published 2025-09-18, still points at mcp.mermaidchart.com" ], "score": 66 }, "pageJsonUrl": "https://www.anchorterminal.com/tools/mermaid-chart.json", "live": { "slug": "mermaid-chart", "probe": { "target": "https://mcp.mermaid.ai/mcp", "method": "mcp-initialize", "lastAt": "2026-10-04T23:48:11.748933463Z", "lastOk": true, "lastStatus": 200, "lastMs": 431, "lastNote": "initialize answered", "authRequired": false, "uptime24h": 100, "uptime30d": 100, "p50ms24h": 465, "p95ms24h": 564, "samples24h": 272, "samples30d": 1100, "days": [ { "date": "2026-09-30", "probes": 35, "ok": 35 }, { "date": "2026-10-01", "probes": 276, "ok": 276 }, { "date": "2026-10-02", "probes": 248, "ok": 248 }, { "date": "2026-10-03", "probes": 271, "ok": 271 }, { "date": "2026-10-04", "probes": 270, "ok": 270 } ] }, "versions": [ { "registry": "mcp-registry", "name": "com.mermaidchart/mermaid-mcp", "version": "1.0.0", "seenAt": "2026-10-04T23:42:40.113054682Z" }, { "registry": "npm", "name": "@mermaidchart/sdk", "version": "0.2.8", "seenAt": "2026-10-04T16:32:56.186996112Z" } ], "npmWeekly": 396, "securityTxt": { "url": "https://mermaid.ai/.well-known/security.txt", "state": "unknown", "checkedAt": "2026-10-04T15:16:05.125361402Z" }, "domain": { "domain": "mermaid.ai", "registered": "2017-12-16", "source": "https://rdap.identitydigital.services/rdap/domain/mermaid.ai", "checkedAt": "2026-10-04T13:04:50.094930879Z" }, "pages": [ { "url": "https://mermaid.ai/pricing", "kind": "pricing", "status": 304, "checkedAt": "2026-10-04T15:45:52.901253273Z", "changedAt": "0001-01-01T00:00:00Z", "fingerprint": "e3b0c44298fc" }, { "url": "https://mermaid.ai/privacy-policy", "kind": "privacy", "status": 200, "checkedAt": "2026-10-01T13:14:15.99559282Z", "changedAt": "0001-01-01T00:00:00Z", "fingerprint": "6adb40a489d6" }, { "url": "https://mermaid.ai/web/privacy-policy", "kind": "privacy", "status": 304, "checkedAt": "2026-10-04T15:45:57.087908761Z", "changedAt": "0001-01-01T00:00:00Z", "fingerprint": "6adb40a489d6" }, { "url": "https://mermaid.ai/terms-and-conditions", "kind": "terms", "status": 304, "checkedAt": "2026-10-04T15:45:55.113516464Z", "changedAt": "0001-01-01T00:00:00Z", "fingerprint": "828240567260" } ], "mcpTools": { "url": "https://mcp.mermaid.ai/mcp", "checkedAt": "2026-10-04T22:19:47.546353564Z", "status": "ok", "protocol": "2025-11-25", "tools": [ { "name": "validate_and_render_mermaid_diagram", "description": "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.", "inputSchema": { "$schema": "http://json-schema.org/draft-07/schema#", "properties": { "clientName": { "description": "REQUIRED: The name of the client/agent using the MCP server (e.g., 'claude', 'cursor', 'vscode', 'chatgpt', 'copilot') for analytics tracking.", "type": "string" }, "diagramType": { "description": "The type of Mermaid diagram (e.g., 'flowchart', 'sequenceDiagram', 'gantt').", "type": "string" }, "mermaidCode": { "description": "Mermaid code to render. Mermaid validates automatically during rendering - if invalid, tool returns error details for fixing.", "type": "string" }, "prompt": { "description": "A text description of the diagram to generate.", "type": "string" }, "useUrlShortener": { "default": true, "description": "Whether to use URL shortening for the Mermaid link. Defaults to true, set to false to disable shortening.", "type": "boolean" } }, "required": [ "prompt", "mermaidCode", "diagramType", "clientName" ], "type": "object" }, "annotations": { "readOnlyHint": true } }, { "name": "get_diagram_title", "description": "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.", "inputSchema": { "$schema": "http://json-schema.org/draft-07/schema#", "properties": { "clientName": { "description": "REQUIRED: The name of the client/agent using the MCP server (e.g., 'claude', 'cursor', 'vscode', 'chatgpt', 'copilot') for analytics tracking.", "type": "string" }, "currentTitle": { "description": "Optional: The current title of the diagram, if any, for context.", "type": "string" }, "diagramContent": { "description": "The Mermaid diagram content/code for which to generate a title.", "type": "string" }, "diagramType": { "description": "Optional: The type of Mermaid diagram (e.g., 'flowchart', 'sequenceDiagram', 'gantt') for better context in title generation.", "type": "string" } }, "required": [ "diagramContent", "clientName" ], "type": "object" }, "annotations": { "readOnlyHint": true } }, { "name": "get_diagram_summary", "description": "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.", "inputSchema": { "$schema": "http://json-schema.org/draft-07/schema#", "properties": { "clientName": { "description": "REQUIRED: The name of the client/agent using the MCP server (e.g., 'claude', 'cursor', 'vscode', 'chatgpt', 'copilot') for analytics tracking.", "type": "string" }, "contextHint": { "description": "Optional: Context hint to help generate a more accurate summary.", "type": "string" }, "diagramContent": { "description": "The Mermaid diagram content/code for which to generate a summary.", "type": "string" } }, "required": [ "diagramContent", "clientName" ], "type": "object" }, "annotations": { "readOnlyHint": true } }, { "name": "search_mermaid_icons", "description": "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.", "inputSchema": { "$schema": "http://json-schema.org/draft-07/schema#", "properties": { "clientName": { "description": "REQUIRED: The name of the client/agent using the MCP server (e.g., 'claude', 'cursor', 'vscode', 'chatgpt', 'copilot') for analytics tracking.", "type": "string" }, "limit": { "default": 10, "description": "Optional: Maximum number of results to return per provider. Defaults to 10 for performance. Increase if needed.", "type": "number" }, "provider": { "description": "Optional: Filter by specific provider ('aws', 'azure', 'gcp', 'fa'). If not provided, searches all providers.", "type": "string" }, "query": { "description": "Search query for icons (e.g., 'aws', 'azure', 'gcp', 'fa', 'lambda', 's3', 'database'). Use specific terms for better results.", "type": "string" } }, "required": [ "query", "clientName" ], "type": "object" }, "annotations": { "readOnlyHint": true } }, { "name": "get_mermaid_syntax_document", "description": "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.", "inputSchema": { "$schema": "http://json-schema.org/draft-07/schema#", "properties": { "clientName": { "description": "REQUIRED: The name of the client/agent using the MCP server (e.g., 'claude', 'cursor', 'vscode', 'chatgpt', 'copilot') for analytics tracking.", "type": "string" }, "diagramType": { "description": "The type of Mermaid diagram to get syntax documentation for (e.g., 'flowchart', 'sequenceDiagram', 'architecture-beta', 'gantt', 'gitgraph', 'classDiagram', 'stateDiagram', etc.).", "type": "string" } }, "required": [ "diagramType", "clientName" ], "type": "object" }, "annotations": { "readOnlyHint": true } }, { "name": "list_tools", "description": "Lists all available MCP servers and their tools in the workspace.", "inputSchema": { "$schema": "http://json-schema.org/draft-07/schema#", "properties": { "clientName": { "description": "OPTIONAL: The name of the client/agent using the MCP server (e.g., 'claude', 'cursor', 'vscode', 'chatgpt', 'copilot') for analytics tracking.", "type": "string" } }, "type": "object" }, "annotations": { "readOnlyHint": true } }, { "name": "list_repos", "description": "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.", "inputSchema": { "$schema": "http://json-schema.org/draft-07/schema#", "properties": { "clientName": { "description": "REQUIRED: The name of the client/agent using the MCP server for analytics tracking.", "type": "string" }, "org": { "description": "Optional: organization login. If set, lists that org's repositories; otherwise lists repos for the authenticated user.", "type": "string" }, "page": { "default": 1, "maximum": 9007199254740991, "minimum": 1, "type": "integer" }, "per_page": { "default": 30, "maximum": 100, "minimum": 1, "type": "integer" }, "type": { "default": "all", "description": "User repo filter; ignored when `org` is set.", "enum": [ "all", "owner", "member", "public", "private" ], "type": "string" } }, "required": [ "clientName" ], "type": "object" }, "annotations": { "readOnlyHint": true } }, { "name": "list_mermaid_files", "description": "List .mmd Mermaid files in a GitHub repository (code search with tree fallback). REQUIRES: `Github-Token` header (HTTP) or GITHUB_TOKEN / GH_TOKEN.", "inputSchema": { "$schema": "http://json-schema.org/draft-07/schema#", "properties": { "clientName": { "description": "REQUIRED: The name of the client/agent using the MCP server for analytics tracking.", "type": "string" }, "owner": { "description": "Repository owner (user or organization).", "type": "string" }, "ref": { "description": "Optional branch, tag, or commit for tree fallback when code search is unavailable.", "type": "string" }, "repo": { "description": "Repository name.", "type": "string" } }, "required": [ "owner", "repo", "clientName" ], "type": "object" }, "annotations": { "readOnlyHint": true } }, { "name": "read_mermaid_file", "description": "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.", "inputSchema": { "$schema": "http://json-schema.org/draft-07/schema#", "properties": { "clientName": { "description": "REQUIRED: The name of the client/agent using the MCP server for analytics tracking.", "type": "string" }, "owner": { "type": "string" }, "path": { "description": "Path to the .mmd file in the repository.", "type": "string" }, "ref": { "description": "Optional: branch, tag, or commit SHA; defaults to the default branch.", "type": "string" }, "repo": { "type": "string" } }, "required": [ "owner", "repo", "path", "clientName" ], "type": "object" }, "annotations": { "readOnlyHint": true } }, { "name": "create_pr", "description": "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).", "inputSchema": { "$schema": "http://json-schema.org/draft-07/schema#", "properties": { "baseBranch": { "description": "Branch to base the PR on (e.g. main). Defaults to the repo default branch.", "type": "string" }, "body": { "description": "PR description (markdown).", "type": "string" }, "clientName": { "description": "REQUIRED: The name of the client/agent using the MCP server for analytics tracking.", "type": "string" }, "commitMessage": { "description": "Single commit message for the file changes.", "type": "string" }, "files": { "description": "Files to add or update.", "items": { "properties": { "content": { "description": "Full UTF-8 file content.", "type": "string" }, "path": { "description": "Repo-relative file path.", "type": "string" } }, "required": [ "path", "content" ], "type": "object" }, "minItems": 1, "type": "array" }, "headBranch": { "description": "Name of the new branch (must not already exist on the remote).", "type": "string" }, "owner": { "type": "string" }, "repo": { "type": "string" }, "title": { "type": "string" } }, "required": [ "owner", "repo", "headBranch", "title", "body", "commitMessage", "files", "clientName" ], "type": "object" }, "annotations": { "readOnlyHint": false } }, { "name": "push_file", "description": "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.", "inputSchema": { "$schema": "http://json-schema.org/draft-07/schema#", "properties": { "branch": { "description": "Branch to commit to.", "type": "string" }, "clientName": { "description": "REQUIRED: The name of the client/agent using the MCP server for analytics tracking.", "type": "string" }, "content": { "description": "Full file content.", "type": "string" }, "message": { "description": "Commit message.", "type": "string" }, "owner": { "type": "string" }, "path": { "type": "string" }, "repo": { "type": "string" }, "sha": { "description": "Existing blob SHA to update; omit to create or to let the service detect.", "type": "string" } }, "required": [ "owner", "repo", "path", "content", "branch", "message", "clientName" ], "type": "object" }, "annotations": { "readOnlyHint": false } }, { "name": "list_pulls", "description": "List pull requests for a GitHub repository. REQUIRES: `Github-Token` (HTTP) or GITHUB_TOKEN / GH_TOKEN.", "inputSchema": { "$schema": "http://json-schema.org/draft-07/schema#", "properties": { "clientName": { "description": "REQUIRED: The name of the client/agent using the MCP server for analytics tracking.", "type": "string" }, "owner": { "type": "string" }, "page": { "default": 1, "maximum": 9007199254740991, "minimum": 1, "type": "integer" }, "per_page": { "default": 30, "maximum": 100, "minimum": 1, "type": "integer" }, "repo": { "type": "string" }, "state": { "default": "open", "enum": [ "open", "closed", "all" ], "type": "string" } }, "required": [ "owner", "repo", "clientName" ], "type": "object" }, "annotations": { "readOnlyHint": true } }, { "name": "list_branches", "description": "List or resolve branch names. **List mode (default):** one `GET /repos/.../branches?per_page=100\u0026page=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.", "inputSchema": { "$schema": "http://json-schema.org/draft-07/schema#", "properties": { "branch_name": { "description": "Exact branch name. When non-empty, returns that branch only. Omit to fetch the first 100 branches only.", "type": "string" }, "clientName": { "description": "REQUIRED: The name of the client/agent using the MCP server for analytics tracking.", "type": "string" }, "owner": { "type": "string" }, "repo": { "type": "string" } }, "required": [ "owner", "repo", "clientName" ], "type": "object" }, "annotations": { "readOnlyHint": true } }, { "name": "list_issues", "description": "List issues for a repository (excludes pull requests). REQUIRES: `Github-Token` (HTTP) or GITHUB_TOKEN / GH_TOKEN.", "inputSchema": { "$schema": "http://json-schema.org/draft-07/schema#", "properties": { "clientName": { "description": "REQUIRED: The name of the client/agent using the MCP server for analytics tracking.", "type": "string" }, "direction": { "default": "desc", "enum": [ "asc", "desc" ], "type": "string" }, "labels": { "description": "Comma-separated label names (GitHub API format).", "type": "string" }, "owner": { "type": "string" }, "page": { "default": 1, "maximum": 9007199254740991, "minimum": 1, "type": "integer" }, "per_page": { "default": 30, "maximum": 100, "minimum": 1, "type": "integer" }, "repo": { "type": "string" }, "since": { "description": "ISO 8601: only issues updated at or after this time.", "type": "string" }, "sort": { "default": "created", "enum": [ "created", "updated", "comments" ], "type": "string" }, "state": { "default": "open", "enum": [ "open", "closed", "all" ], "type": "string" } }, "required": [ "owner", "repo", "clientName" ], "type": "object" }, "annotations": { "readOnlyHint": true } }, { "name": "create_issue", "description": "Create an issue in a GitHub repository. REQUIRES: `Github-Token` (HTTP) or GITHUB_TOKEN with issues write if creating issues in private repos.", "inputSchema": { "$schema": "http://json-schema.org/draft-07/schema#", "properties": { "body": { "description": "Issue body in markdown.", "type": "string" }, "clientName": { "description": "REQUIRED: The name of the client/agent using the MCP server for analytics tracking.", "type": "string" }, "labels": { "description": "Label names (must already exist in the repository).", "items": { "type": "string" }, "type": "array" }, "owner": { "type": "string" }, "repo": { "type": "string" }, "title": { "type": "string" } }, "required": [ "owner", "repo", "title", "clientName" ], "type": "object" }, "annotations": { "readOnlyHint": false } }, { "name": "get_issue_comments", "description": "List comments on an issue by issue number. REQUIRES: `Github-Token` (HTTP) or GITHUB_TOKEN / GH_TOKEN.", "inputSchema": { "$schema": "http://json-schema.org/draft-07/schema#", "properties": { "clientName": { "description": "REQUIRED: The name of the client/agent using the MCP server for analytics tracking.", "type": "string" }, "issue_number": { "description": "Issue number (not a PR number unless the PR is also addressed as an issue on GitHub).", "maximum": 9007199254740991, "minimum": 1, "type": "integer" }, "owner": { "type": "string" }, "page": { "default": 1, "maximum": 9007199254740991, "minimum": 1, "type": "integer" }, "per_page": { "default": 30, "maximum": 100, "minimum": 1, "type": "integer" }, "repo": { "type": "string" } }, "required": [ "owner", "repo", "issue_number", "clientName" ], "type": "object" }, "annotations": { "readOnlyHint": true } }, { "name": "get_pull_comments", "description": "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.", "inputSchema": { "$schema": "http://json-schema.org/draft-07/schema#", "properties": { "clientName": { "description": "REQUIRED: The name of the client/agent using the MCP server for analytics tracking.", "type": "string" }, "owner": { "type": "string" }, "page": { "default": 1, "maximum": 9007199254740991, "minimum": 1, "type": "integer" }, "per_page": { "default": 30, "maximum": 100, "minimum": 1, "type": "integer" }, "pull_number": { "description": "Pull request number.", "maximum": 9007199254740991, "minimum": 1, "type": "integer" }, "repo": { "type": "string" } }, "required": [ "owner", "repo", "pull_number", "clientName" ], "type": "object" }, "annotations": { "readOnlyHint": true } }, { "name": "generate_ticket_dependency_tree", "description": "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.", "inputSchema": { "$schema": "http://json-schema.org/draft-07/schema#", "properties": { "assignee": { "description": "Filter by assignee — Jira account ID, display name, or 'currentUser()'.", "type": "string" }, "clientName": { "description": "REQUIRED: The name of the client/agent using the MCP server for analytics tracking.", "minLength": 1, "type": "string" }, "colorMode": { "default": "light", "description": "Color scheme for the diagram: 'light' (default pastel fills), 'dark' (deep fills for dark backgrounds), or 'none' (no fill/stroke overrides, inherits the Mermaid theme).", "enum": [ "light", "dark", "none" ], "type": "string" }, "createdAfter": { "description": "Include only issues created on or after this date, ISO format: '2024-01-15'.", "type": "string" }, "createdBefore": { "description": "Include only issues created on or before this date, ISO format: '2024-03-31'.", "type": "string" }, "maxResults": { "default": 50, "description": "Target number of issues to render in the tree (1–100, default 50).", "maximum": 100, "minimum": 1, "type": "integer" }, "projectKey": { "description": "REQUIRED: Jira project key, e.g. 'PROJ' or 'MYTEAM'. Used as the base JQL project filter.", "minLength": 1, "type": "string" }, "reporter": { "description": "Filter by reporter — Jira account ID or display name.", "type": "string" }, "sprint": { "description": "Filter by sprint name or numeric ID, e.g. 'Sprint 12' or '42'.", "type": "string" }, "status": { "description": "Filter by issue status, e.g. 'In Progress', 'To Do', 'Done'.", "type": "string" }, "useUrlShortener": { "default": true, "description": "Shorten the preview/edit URL via Short.io. Disable to get the full unshortened URL (default true).", "type": "boolean" } }, "required": [ "projectKey", "clientName" ], "type": "object" }, "annotations": { "readOnlyHint": true } }, { "name": "generate_jira_kanban_board", "description": "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.", "inputSchema": { "$schema": "http://json-schema.org/draft-07/schema#", "properties": { "assignee": { "description": "Filter by assignee — Jira account ID, display name, or 'currentUser()'.", "type": "string" }, "clientName": { "description": "REQUIRED: The name of the client/agent using the MCP server for analytics tracking.", "minLength": 1, "type": "string" }, "issueType": { "description": "Filter by issue type, e.g. 'Story', 'Bug', 'Task'.", "type": "string" }, "maxResults": { "default": 50, "description": "Maximum number of issues to fetch (1–100, default 50).", "maximum": 100, "minimum": 1, "type": "integer" }, "projectKey": { "description": "REQUIRED: Jira project key, e.g. 'PROJ' or 'MYTEAM'.", "minLength": 1, "type": "string" }, "sprint": { "description": "Filter by sprint name or numeric ID, e.g. 'Sprint 12' or '42'.", "type": "string" } }, "required": [ "projectKey", "clientName" ], "type": "object" }, "annotations": { "readOnlyHint": true } }, { "name": "generate_ticket_diagram", "description": "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.", "inputSchema": { "$schema": "http://json-schema.org/draft-07/schema#", "properties": { "clientName": { "description": "REQUIRED: The name of the client/agent using the MCP server for analytics tracking.", "minLength": 1, "type": "string" }, "colorMode": { "default": "light", "description": "Color scheme for the diagram: 'light' (default pastel fills), 'dark' (deep fills for dark backgrounds), or 'none' (no fill/stroke overrides, inherits the Mermaid theme).", "enum": [ "light", "dark", "none" ], "type": "string" }, "ticketKey": { "description": "REQUIRED: Jira issue key, e.g. 'MC-123' or 'PROJ-42'.", "minLength": 1, "type": "string" } }, "required": [ "ticketKey", "clientName" ], "type": "object" }, "annotations": { "readOnlyHint": true } }, { "name": "generate_ticket_timeline", "description": "Generate a Mermaid diagram showing the history of a single Jira ticket using its changelog. Two views are available:\n- **state**: stateDiagram-v2 showing all status transitions with dates and authors, nodes coloured by status category.\n- **timeline** (default): Mermaid timeline grouped by month, showing status changes, assignee changes, priority changes, sprint moves, and resolutions.", "inputSchema": { "$schema": "http://json-schema.org/draft-07/schema#", "properties": { "clientName": { "description": "REQUIRED: The name of the client/agent using the MCP server for analytics tracking.", "minLength": 1, "type": "string" }, "ticketKey": { "description": "REQUIRED: Jira issue key, e.g. 'MC-123' or 'PROJ-42'.", "minLength": 1, "type": "string" }, "view": { "default": "timeline", "description": "Diagram view to generate. 'state' shows status transitions; 'timeline' shows all field changes over time.", "enum": [ "state", "timeline" ], "type": "string" } }, "required": [ "ticketKey", "clientName" ], "type": "object" }, "annotations": { "readOnlyHint": true } }, { "name": "get_notion_page_mermaid_diagrams", "description": "Extract all Mermaid code blocks from a Notion page. Returns block ID, diagram code, and optional caption for each block.", "inputSchema": { "$schema": "http://json-schema.org/draft-07/schema#", "properties": { "clientName": { "description": "REQUIRED: The name of the client/agent using the MCP server for analytics tracking.", "type": "string" }, "pageUrl": { "description": "URL of the Notion page (e.g. https://www.notion.so/My-Page-abc123...).", "format": "uri", "type": "string" } }, "required": [ "pageUrl", "clientName" ], "type": "object" }, "annotations": { "readOnlyHint": true } }, { "name": "get_notion_mermaid_diagram_by_block_id", "description": "Retrieve a single Mermaid diagram block by its block ID. Returns the diagram code and optional caption.", "inputSchema": { "$schema": "http://json-schema.org/draft-07/schema#", "properties": { "blockId": { "description": "The Notion block ID of the mermaid code block (e.g. from get_notion_page_mermaid_diagrams).", "type": "string" }, "clientName": { "description": "REQUIRED: The name of the client/agent using the MCP server for analytics tracking.", "type": "string" } }, "required": [ "blockId", "clientName" ], "type": "object" }, "annotations": { "readOnlyHint": true } }, { "name": "update_notion_mermaid_diagram", "description": "Update the Mermaid source code (and optional caption) of an existing mermaid code block by its block ID.", "inputSchema": { "$schema": "http://json-schema.org/draft-07/schema#", "properties": { "blockId": { "description": "The Notion block ID of the mermaid code block to update.", "type": "string" }, "caption": { "description": "Optional new caption. Omit to clear the existing caption.", "type": "string" }, "clientName": { "description": "REQUIRED: The name of the client/agent using the MCP server for analytics tracking.", "type": "string" }, "code": { "description": "New Mermaid diagram source code.", "type": "string" } }, "required": [ "blockId", "code", "clientName" ], "type": "object" }, "annotations": { "readOnlyHint": false } }, { "name": "insert_notion_mermaid_diagram", "description": "Append a Mermaid diagram as a code block to a Notion page. The block is added at the end of the page content.", "inputSchema": { "$schema": "http://json-schema.org/draft-07/schema#", "properties": { "caption": { "description": "Optional caption displayed below the code block.", "type": "string" }, "clientName": { "description": "REQUIRED: The name of the client/agent using the MCP server for analytics tracking.", "type": "string" }, "code": { "description": "Mermaid diagram source code.", "type": "string" }, "pageUrl": { "description": "URL of the Notion page to insert the diagram into.", "format": "uri", "type": "string" } }, "required": [ "pageUrl", "code", "clientName" ], "type": "object" }, "annotations": { "readOnlyHint": false } } ], "schemaTokens": 6198, "changedAt": "2026-09-30T21:57:02.278667952Z", "check": { "checker": "anchor-check/1.0", "totalTokens": 6198, "counts": { "error": 0, "note": 1, "warn": 11 }, "findings": [ { "rule": "TC11", "severity": "warn", "tool": "create_issue", "message": "3 parameters without a description: owner, repo, title", "fix": "Describe each one: format, units, an example, and what happens when it's left out." }, { "rule": "TC11", "severity": "warn", "tool": "create_pr", "message": "3 parameters without a description: owner, repo, title", "fix": "Describe each one: format, units, an example, and what happens when it's left out." }, { "rule": "TC11", "severity": "warn", "tool": "get_issue_comments", "message": "4 parameters without a description: owner, page, per_page, repo", "fix": "Describe each one: format, units, an example, and what happens when it's left out." }, { "rule": "TC11", "severity": "warn", "tool": "get_pull_comments", "message": "4 parameters without a description: owner, page, per_page, repo", "fix": "Describe each one: format, units, an example, and what happens when it's left out." }, { "rule": "TC11", "severity": "warn", "tool": "list_branches", "message": "2 parameters without a description: owner, repo", "fix": "Describe each one: format, units, an example, and what happens when it's left out." }, { "rule": "TC11", "severity": "warn", "tool": "list_issues", "message": "7 parameters without a description: direction, owner, page, per_page, repo, sort and 1 more", "fix": "Describe each one: format, units, an example, and what happens when it's left out." }, { "rule": "TC11", "severity": "warn", "tool": "list_pulls", "message": "5 parameters without a description: owner, page, per_page, repo, state", "fix": "Describe each one: format, units, an example, and what happens when it's left out." }, { "rule": "TC11", "severity": "warn", "tool": "list_repos", "message": "2 parameters without a description: page, per_page", "fix": "Describe each one: format, units, an example, and what happens when it's left out." }, { "rule": "TC11", "severity": "warn", "tool": "push_file", "message": "3 parameters without a description: owner, path, repo", "fix": "Describe each one: format, units, an example, and what happens when it's left out." }, { "rule": "TC11", "severity": "warn", "tool": "read_mermaid_file", "message": "2 parameters without a description: owner, repo", "fix": "Describe each one: format, units, an example, and what happens when it's left out." }, { "rule": "TC21", "severity": "warn", "tool": "list_pulls", "message": "described almost the same as list_issues (82% of the same words)", "fix": "Say in each description when to use it instead of the other." }, { "rule": "TC24", "severity": "note", "message": "25 of 25 tools have no outputSchema", "fix": "Declare outputSchema for tools that return structured data, and return structuredContent that matches it." } ] } }, "updatedAt": "2026-10-04T23:48:11.748933463Z" } }, "summary": "Diagrams.so API + MCP has a score of 60.1 (C) against Mermaid Chart MCP's 31.7 (F). Both do diagram create. The largest gap is schema \u0026 documentation, 53 points." }, "kind": "anchor.page", "links": { "api": "https://www.anchorterminal.com/api/v1/index.json", "html": "https://www.anchorterminal.com/compare/diagrams-so-vs-mermaid-chart", "json": "https://www.anchorterminal.com/compare/diagrams-so-vs-mermaid-chart.json", "llms": "https://www.anchorterminal.com/llms.txt", "markdown": "https://www.anchorterminal.com/compare/diagrams-so-vs-mermaid-chart.md", "slim": "https://www.anchorterminal.com/compare/diagrams-so-vs-mermaid-chart.min.md" }, "markdown": "Diagrams.so API + MCP has a score of 60.1 (C) against Mermaid Chart MCP's 31.7 (F). Both do diagram create. The largest gap is schema \u0026 documentation, 53 points.\n\n- Diagrams.so API + MCP: grade C, 60.1/100, rank #255 of 452. Markdown https://www.anchorterminal.com/tools/diagrams-so.md · JSON https://www.anchorterminal.com/api/v1/tools/diagrams-so.json\n- Mermaid Chart MCP: grade F, 31.7/100, rank #442 of 452. Markdown https://www.anchorterminal.com/tools/mermaid-chart.md · JSON https://www.anchorterminal.com/api/v1/tools/mermaid-chart.json\n\n## Which one, for what\n\nPick Diagrams.so API + MCP for reliability (+15), schema \u0026 documentation (+53), agent ergonomics (+51), security \u0026 auth (+47), maintenance \u0026 community (+18), transparency \u0026 trust (+27).\n\nPick Mermaid Chart MCP for payments \u0026 pricing (+13).\n\n## Score by category\n\n| Category | Weight | Diagrams.so API + MCP | Mermaid Chart MCP | Edge |\n| --- | --- | --- | --- | --- |\n| Reliability | 16% (20 this run) | 30 | 15 | Diagrams.so API + MCP +15 |\n| Performance | 10%, pending | pending | pending | not scored in this run |\n| Schema \u0026 documentation | 13% (16.2 this run) | 85 | 32 | Diagrams.so API + MCP +53 |\n| Agent ergonomics | 13% (16.2 this run) | 85 | 34 | Diagrams.so API + MCP +51 |\n| Security \u0026 auth | 14% (17.5 this run) | 67 | 20 | Diagrams.so API + MCP +47 |\n| Payments \u0026 pricing | 10% (12.5 this run) | 32 | 45 | Mermaid Chart MCP +13 |\n| Task success | 10%, pending | pending | pending | not scored in this run |\n| Maintenance \u0026 community | 7% (8.8 this run) | 71 | 53 | Diagrams.so API + MCP +18 |\n| Transparency \u0026 trust | 7% (8.8 this run) | 75 | 48 | Diagrams.so API + MCP +27 |\n| Negative events | ≤15 | -2 | 0 | |\n| **Total** | | **60.1 · C** | **31.7 · F** | |\n\n## Facts side by side\n\n| Fact | Diagrams.so API + MCP | Mermaid Chart MCP |\n| --- | --- | --- |\n| Kind | HTTP API | MCP server |\n| Vendor | Diagrams.so (RedHold LLC) | Mermaid Chart |\n| Hosted endpoint | `https://api.diagrams.so/api/v2` | `https://mcp.mermaid.ai/mcp` |\n| Transports | HTTP, stdio | Streamable HTTP, SSE (legacy) |\n| Auth | OAuth or key | OAuth or key |\n| Pricing | Freemium | Freemium |\n| x402 | no | no |\n| Licence | Apache-2.0 | none |\n| Tools exposed | 23 | 25 |\n| Context cost (tools/list) | n/a | n/a |\n| p95 latency | not measured yet | not measured yet |\n| Availability (30d) | not measured yet | not measured yet |\n| Read-only variant documented | no | no |\n| llms.txt | yes | no |\n| MCP registry | `io.github.RedHold/diagrams-so-mcp` | `com.mermaidchart/mermaid-mcp` |\n| Last release | 2026-08-19 | 2026-09-17 |\n| Popularity | 0 stars, 172 npm/wk, 3 PyPI/wk | 395 npm/wk |\n| Agent reviews | 4/5 (2) | 2.5/5 (2) |\n\n## Verdicts\n\n**Diagrams.so API + MCP.** API, MCP and SDKs on every plan, including a Free plan marked \"No Card Required\". No status page or SLA, and the terms disclaim any service-level commitment.\n\n**Mermaid Chart MCP.** Validation and rendering work with no account or key. Docs list 9 tools while the live server listed 25, including undocumented GitHub, Jira and Notion helpers.\n\n## Before you call either\n\n### Diagrams.so API + MCP\n\n1. Send an Idempotency-Key on generate, edit, fix and re-layout. If a billable call times out, check `get_usage_history` before retrying\n2. Generation is synchronous and can run for minutes. The SDKs default to a 450 s timeout, or use `POST /diagrams/stream`\n3. Call `list_capabilities` first. `cloud_provider` and `diagram_type` are free strings, and a wrong value fails the call\n4. `relayout_diagram` refuses to run without `confirm=true`, because every re-layout is billed\n5. Test keys (dgz_test_) spend the same credits as live keys\n\n### Mermaid Chart MCP\n\n1. Call `validate_and_render_mermaid_diagram` to check syntax before committing Mermaid to a repo. It needs no token\n2. Only add the token if you need to save into Mermaid Chart projects. It reaches every project on the account\n3. If you only need a picture, the open-source mermaid-cli renders locally with no network call\n4. Use mcp.mermaid.ai. The registry still lists the older mcp.mermaidchart.com host\n\n## Other comparisons with Diagrams.so API + MCP or Mermaid Chart MCP\n\n- [Cloudviz API vs Diagrams.so API + MCP](https://www.anchorterminal.com/compare/cloudviz-vs-diagrams-so.md)\n- [Cloudviz API vs Mermaid Chart MCP](https://www.anchorterminal.com/compare/cloudviz-vs-mermaid-chart.md)\n- [Diagrams.so API + MCP vs draw.io + MCP](https://www.anchorterminal.com/compare/diagrams-so-vs-drawio.md)\n- [Diagrams.so API + MCP vs Eraser API + MCP](https://www.anchorterminal.com/compare/diagrams-so-vs-eraser.md)\n- [Diagrams.so API + MCP vs Lucid API + MCP](https://www.anchorterminal.com/compare/diagrams-so-vs-lucid.md)\n- [Diagrams.so API + MCP vs Structurizr + MCP](https://www.anchorterminal.com/compare/diagrams-so-vs-structurizr.md)\n- [Diagrams.so API + MCP vs tldraw SDK + MCP](https://www.anchorterminal.com/compare/diagrams-so-vs-tldraw.md)\n- [Diagrams.so API + MCP vs Whimsical MCP](https://www.anchorterminal.com/compare/diagrams-so-vs-whimsical.md)\n- [draw.io + MCP vs Mermaid Chart MCP](https://www.anchorterminal.com/compare/drawio-vs-mermaid-chart.md)\n- [Eraser API + MCP vs Mermaid Chart MCP](https://www.anchorterminal.com/compare/eraser-vs-mermaid-chart.md)\n- [Lucid API + MCP vs Mermaid Chart MCP](https://www.anchorterminal.com/compare/lucid-vs-mermaid-chart.md)\n- [Mermaid Chart MCP vs Structurizr + MCP](https://www.anchorterminal.com/compare/mermaid-chart-vs-structurizr.md)\n- [Mermaid Chart MCP vs tldraw SDK + MCP](https://www.anchorterminal.com/compare/mermaid-chart-vs-tldraw.md)\n- [Mermaid Chart MCP vs Whimsical MCP](https://www.anchorterminal.com/compare/mermaid-chart-vs-whimsical.md)\n", "meta": { "attribution": "Anchor Terminal (https://www.anchorterminal.com)", "docs": "https://www.anchorterminal.com/docs/", "generatedAt": "2026-10-04", "license": "CC-BY-4.0", "method": "https://www.anchorterminal.com/benchmark/", "methodology": "0.3", "openapi": "https://www.anchorterminal.com/openapi.json", "preview": false, "run": "2026-10-01", "runLabel": "October 2026 research run" }, "page": { "breadcrumbs": [ { "name": "Home", "url": "https://www.anchorterminal.com/" }, { "name": "Compare", "url": "https://www.anchorterminal.com/compare/" }, { "name": "Diagrams.so API + MCP vs Mermaid Chart MCP", "url": "" } ], "description": "Diagrams.so API + MCP has a score of 60.1 (C) against Mermaid Chart MCP's 31.7 (F). Both do diagram create. The largest gap is schema \u0026 documentation, 53 points. Category scores, facts, verdicts and agent notes side by side.", "facts": [ "Diagrams.so API + MCP C 60.1", "Mermaid Chart MCP F 31.7", "scores" ], "h1": "Diagrams.so API + MCP vs Mermaid Chart MCP", "image": "https://www.anchorterminal.com/assets/og/compare-diagrams-so-vs-mermaid-chart.png", "path": "/compare/diagrams-so-vs-mermaid-chart", "published": "2026-10-01", "section": "tools", "title": "Diagrams.so API + MCP vs Mermaid Chart MCP for AI agents", "toc": null, "updated": "2026-10-04", "url": "https://www.anchorterminal.com/compare/diagrams-so-vs-mermaid-chart" }, "tokens": { "markdown": 1600, "slim": 380 }, "version": 1 }