{ "data": { "a": { "slug": "ai-diagram-maker-mcp", "name": "AI Diagram Maker MCP", "vendor": "AI Diagram Maker (Rajasekar Elango)", "vendorUrl": "https://www.aidiagrammaker.com", "kind": "mcp", "category": "diagramming", "summary": "AI Diagram Maker MCP is an MIT-licensed MCP server, hosted or run with npx, that sends text, JSON, ASCII art, images or Mermaid to the AI Diagram Maker service and returns a D2 software diagram with an edit link.", "url": "https://www.anchorterminal.com/tools/ai-diagram-maker-mcp", "markdownUrl": "https://www.anchorterminal.com/tools/ai-diagram-maker-mcp.md", "slimMarkdownUrl": "https://www.anchorterminal.com/tools/ai-diagram-maker-mcp.min.md", "jsonUrl": "https://www.anchorterminal.com/api/v1/tools/ai-diagram-maker-mcp.json", "dns": "ai-diagram-maker-mcp.grade.anchorterminal.com", "repo": "https://github.com/erajasekar/ai-diagram-maker-mcp", "license": "MIT for the MCP server. The AI Diagram Maker service it calls is closed, under terms last updated 24 September 2025", "transports": [ "streamable-http", "stdio" ], "remoteUrl": "https://mcp.aidiagrammaker.com/mcp", "packages": [ { "registry": "npm", "name": "ai-diagram-maker-mcp" } ], "auth": "api-key", "authNotes": "An API key created in the AI Diagram Maker app under Settings \u003e API Keys, shown once, named, and deactivated, reactivated or deleted from the same page. No scopes; the user guide says anyone with the key can access the account. The hosted server takes it in `X-ADM-API-Key` or `Authorization: Bearer`, the local server in `ADM_API_KEY`. No OAuth.", "pricing": "freemium", "pricingNotes": "Basic is free with 50 AI credits a month. Plus $10 a month ($96 a year) with 250 credits, Max $20 a month ($192 a year) with 500. One credit is 1,000 tokens, and extra credits can't be bought. Which plans include API and MCP use isn't stated.", "priceSummary": "$10 / mo", "where": "both", "x402": { "level": "no", "evidence": "Plans sold through Lemon Squeezy checkout links. No x402, MPP or L402 in the repository, the OpenAPI file or the site (checked 2026-11-06). Out of credits returns 402 with no payment requirements.", "endpoints": [] }, "toolCount": 5, "popularity": { "githubStars": null, "npmWeekly": 63, "pypiWeekly": null, "asOf": "2026-11-06" }, "docsUrl": "https://github.com/erajasekar/ai-diagram-maker-mcp#readme", "openapi": "https://github.com/erajasekar/ai-diagram-maker-mcp/blob/main/apispec/adm-openapi.json", "registryName": "io.github.erajasekar/ai-diagram-maker-mcp", "capabilities": [ "diagram.create", "diagram.architecture", "diagram.as-code", "diagram.export" ], "tags": [ "hosted", "local", "mcp", "remote-mcp", "stdio", "mcp-registry", "openapi", "api-key", "freemium", "d2", "mcp-apps" ], "lastRelease": "2026-04-10", "graded": true, "anchor": { "graded": true, "score": 43.8, "grade": "E", "agentReady": false, "rank": 1225, "ranked": true, "rankOf": 1486, "categoryRank": 13, "methodology": "0.7", "run": "2026-10-01", "scores": { "ergonomics": 66, "maintenance": 17, "payments": 20, "reliability": 30, "schema": 75, "security": 45, "transparency": 35 }, "pending": [ "performance", "tasks" ], "assessment": { "confidence": "medium", "date": "2026-11-06" }, "negative": 0, "verdict": "Five compact, typed tools turn text, JSON, ASCII art, images or Mermaid into an editable D2 diagram, and the API documents its error and rate-limit responses. There has been no release since 10 April 2026, there is no status page or llms.txt, and the API key opens the whole account with no scopes.", "bestFor": "Quick architecture, sequence, ERD and flowchart diagrams from a coding agent, with a link to edit them.", "strengths": [ "Five tools with zod schemas, a diagramType enum and descriptions that say when to use each", "OpenAPI 3 file for the generate endpoint with documented 402, 422 and 429 responses", "A 429 body gives limit, remaining, resetAt and retryAfter", "Hosted endpoint with nothing to install, or a local npx server", "Output stays editable as D2 in the app and exports to SVG, PNG or Mermaid" ], "weaknesses": [ "Last release 3.0.8 on 10 April 2026, and the registry entry still says 1.0.0", "No status page, SLA, llms.txt, changelog or security policy found", "API keys have no scopes and give full account access", "Plans don't say whether API and MCP calls are included, and an open issue asks how hosted MCP credits are counted", "The privacy policy names no AI model providers or other processors" ], "agentNotes": [ "Send the key in the `X-ADM-API-Key` header to https://mcp.aidiagrammaker.com/mcp, never in the URL", "Pick `diagramType` from the enum when the user names one; leave it out to let the service choose", "On a 402 stop and tell the user credits are gone; they reset monthly and can't be topped up", "On a 429 wait for `retryAfter` seconds before the next call", "Give the user the returned diagram link so they can edit it, since the tools can't revise an existing diagram" ], "metrics": { "kind": "remote", "measured": false }, "reviewCount": 0, "avgRating": 0, "history": [ { "basis": "public evidence", "confidence": "medium", "grade": "E", "methodology": "0.7", "pending": [ "performance", "tasks" ], "run": "2026-10-01", "runLabel": "October 2026 research run", "score": 43.8 } ], "editorialScores": { "ergonomics": 66, "maintenance": 17, "payments": 20, "reliability": 30, "schema": 75, "security": 45, "transparency": 28 }, "provenanceScore": 42, "checked": { "categories": { "ergonomics": "2026-11-06", "maintenance": "2026-11-06", "payments": "2026-11-06", "reliability": "2026-11-06", "schema": "2026-11-06", "security": "2026-11-06", "transparency": "2026-11-06" }, "last": "2026-11-06", "oldest": "2026-11-06", "stale": false, "staleAfterDays": 90 } }, "connect": { "install": "ADM_API_KEY=your_api_key npx ai-diagram-maker-mcp@latest", "claudeCode": "claude mcp add ai-diagram-maker -t stdio -e ADM_API_KEY=\u003capi_key\u003e -- npx -y ai-diagram-maker-mcp@latest", "config": { "mcpServers": { "ai-diagram-maker": { "headers": { "X-ADM-API-Key": "YOUR_API_KEY" }, "url": "https://mcp.aidiagrammaker.com/mcp" } } } }, "letme": { "capability": "https://letme.dev/diagram.create", "tool": "https://letme.dev/ai-diagram-maker-mcp" }, "area": "design-diagrams", "unitPrices": [ { "item": "Plus plan", "unit": "month", "usd": 10, "note": "250 AI credits a month; $96 billed yearly" }, { "item": "Max plan", "unit": "month", "usd": 20, "note": "500 AI credits a month; $192 billed yearly" } ], "provenance": { "legalEntity": "", "domain": "aidiagrammaker.com", "domainRegistered": "2025-08-21", "endpointOnVendorDomain": true, "terms": "https://www.aidiagrammaker.com/terms", "privacy": "https://www.aidiagrammaker.com/privacy", "statusPage": "", "changelog": "", "securityTxt": "none", "checked": "2026-11-06", "notes": [ "The terms and privacy policy, both last updated 24 September 2025, name the company only as AI Diagram Maker, under United States law, with aidiagrammaker@gmail.com as the contact. The npm package names Rajasekar Elango as author.", "The terms list scraping among prohibited uses. Public pages were read as data.", "www.aidiagrammaker.com/robots.txt allows all paths.", "RDAP gives aidiagrammaker.com a registration date of 21 August 2025.", "/.well-known/security.txt returns 404. No status page or changelog found; the GitHub releases are the only dated record." ], "score": 42 }, "pageJsonUrl": "https://www.anchorterminal.com/tools/ai-diagram-maker-mcp.json", "live": { "slug": "ai-diagram-maker-mcp", "probe": { "target": "https://mcp.aidiagrammaker.com/mcp", "method": "mcp-initialize", "lastAt": "2026-11-07T18:20:09.018580127Z", "lastOk": false, "lastStatus": 0, "lastMs": 0, "lastNote": "TLS certificate problem", "authRequired": false, "uptime24h": 0, "uptime30d": 0, "p50ms24h": 0, "p95ms24h": 0, "samples24h": 200, "samples30d": 200, "days": [ { "date": "2026-11-06", "probes": 13, "ok": 0 }, { "date": "2026-11-07", "probes": 187, "ok": 0 } ], "outages": [ { "start": "2026-11-06T22:45:03.399368446Z", "end": "0001-01-01T00:00:00Z", "note": "TLS certificate problem" } ] }, "versions": [ { "registry": "mcp-registry", "name": "io.github.erajasekar/ai-diagram-maker-mcp", "version": "1.0.0", "seenAt": "2026-11-07T18:16:28.95801333Z" }, { "registry": "npm", "name": "ai-diagram-maker-mcp", "version": "3.0.8", "seenAt": "2026-11-06T23:04:20.113009064Z" } ], "githubStars": 10, "npmWeekly": 63, "securityTxt": { "url": "https://aidiagrammaker.com/.well-known/security.txt", "state": "none", "checkedAt": "2026-11-07T16:00:48.542497373Z" }, "pages": [ { "url": "https://www.aidiagrammaker.com/privacy", "kind": "privacy", "status": 200, "checkedAt": "2026-11-07T14:24:25.783359417Z", "changedAt": "0001-01-01T00:00:00Z", "fingerprint": "40a879ba4963" }, { "url": "https://www.aidiagrammaker.com/terms", "kind": "terms", "status": 200, "checkedAt": "2026-11-07T14:24:27.95923952Z", "changedAt": "0001-01-01T00:00:00Z", "fingerprint": "9b4e6f213ed0" } ], "mcpTools": { "url": "https://mcp.aidiagrammaker.com/mcp", "checkedAt": "2026-11-07T01:42:20.967941233Z", "status": "error", "note": "Post \"https://mcp.aidiagrammaker.com/mcp\": tls: failed to verify certificate: x509: certificate is valid for *.up.railway.app, up.railway.app, not mcp.aidiagrammaker.com", "changedAt": "2026-11-07T01:42:20.967941233Z" }, "updatedAt": "2026-11-07T18:20:09.018580127Z" } }, "answer": "Diagrams.so API + MCP scores 60.8 (C) on agent readiness against AI Diagram Maker MCP's 43.8 (E), and leads in every scored category.", "b": { "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", "dns": "diagrams-so.grade.anchorterminal.com", "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, created under Settings then API Keys. 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 unlimited diagrams and edits in the app, API, MCP server and SDKs, no card, watermarked images and no editable draw.io file. Paid $20 a month or $120 a year, the same with no watermark and the draw.io file in every reply and export. Nothing is metered; the only limit is a per-minute rate limit. Credit packs, monthly allowances and bring your own key were removed on 9 October 2026. 14-day money-back guarantee on the first payment (https://diagrams.so/pricing).", "priceSummary": "$20 / 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-10-09", "graded": true, "anchor": { "graded": true, "score": 60.8, "grade": "C", "agentReady": false, "rank": 635, "ranked": true, "rankOf": 1486, "categoryRank": 7, "methodology": "0.7", "run": "2026-10-01", "scores": { "ergonomics": 85, "maintenance": 81, "payments": 30, "reliability": 45, "schema": 85, "security": 67, "transparency": 76 }, "pending": [ "performance", "tasks" ], "assessment": { "confidence": "medium", "date": "2026-11-04" }, "negative": -5, "negativeNotes": [ "Published behaviour changed with no notice, 9 October 2026 (-3). The plans page says credit packs, monthly allowances and bring your own key were \"Removed on 9 October 2026\", and on the Free plan replies that carried the draw.io XML now carry `xml: null`, while `export?format=drawio` returns 403 `UPGRADE_REQUIRED` (https://diagrams.so/developers/billing/plans-and-pricing). The changelog entry is dated only 2026-10 and written as in effect, no notice of it was found before that date, and the terms promise 90 days' notice before a documented, generally available capability is retired (https://diagrams.so/policy/terms). The early-August move of the device login to an emailed code, also without notice and fixed in MCP server v1.4.6 on 19 August (https://github.com/RedHold/diagrams-mcp-app-core/blob/main/CHANGELOG.md), is the same kind and folds into this term.", "Undisclosed default telemetry, since August 2026 (-2). The MCP server tags every API request with the running tool's name in an `X-Diagrams-Tool` header, which the source says \"lands in the activity row's metadata\", while the README says the server \"contains no telemetry\" and SECURITY.md mentions only headers identifying the client version (https://github.com/RedHold/diagrams-mcp-app-core/blob/main/src/index.ts). On 1 October this was deducted inside Transparency; this run reads it as a negative event." ], "verdict": "Diagrams.so turns a description into an editable draw.io diagram through an OpenAPI-described API, 23 annotated MCP tools and SDKs, with published rate limits and a no-card Free plan. It has no status page or SLA, and on 9 October it withdrew the draw.io file from Free-plan replies without the notice its terms promise.", "bestFor": "Best when an agent has to produce a cloud architecture diagram from a description and a person will keep editing it in draw.io.", "strengths": [ "OpenAPI 3.1 with 32 operations, and an Idempotency-Key on creates", "All 23 MCP tools carry readOnlyHint or destructiveHint annotations", "Published rate limits per key and per IP, with Retry-After and RateLimit headers", "Free plan with unlimited API, MCP and SDK use and no card", "Editable draw.io XML output on the Paid plan, with architecture warnings and a fix tool" ], "weaknesses": [ "No status page or SLA, and the terms disclaim any service-level commitment", "On 9 October 2026 Free-plan replies lost the draw.io XML with no advance notice", "The MCP server sends each tool's name to the vendor's API while its README says it has no telemetry", "Login is a device flow a person must approve by email, so there's no autonomous signup", "Domain registered in February 2026, and the changelog is dated by month only" ], "agentNotes": [ "On the Free plan expect `xml: null`. Branch on `xml_withheld` and fetch the watermarked SVG from `export_url` with the same key", "Send an Idempotency-Key on generate, edit, fix and re-layout so a retry never makes a second diagram", "Generation is synchronous and can run for minutes. The SDKs default to a 450 s timeout, or use `POST /diagrams/stream`", "Leave `diagram_type` out or send `auto` to let the service pick. `cloud_provider` is a free string, so call `list_capabilities` first", "`relayout_diagram` refuses to run without `confirm=true`" ], "metrics": { "kind": "remote", "measured": false }, "reviewCount": 2, "avgRating": 4, "history": [ { "basis": "public evidence", "confidence": "medium", "grade": "C", "methodology": "0.7", "pending": [ "performance", "tasks" ], "run": "2026-10-01", "runLabel": "October 2026 research run", "score": 60.8 } ], "editorialScores": { "ergonomics": 85, "maintenance": 81, "payments": 30, "reliability": 45, "schema": 85, "security": 67, "transparency": 78 }, "provenanceScore": 74, "checked": { "categories": { "ergonomics": "2026-11-04", "maintenance": "2026-11-04", "payments": "2026-11-04", "reliability": "2026-11-04", "schema": "2026-11-04", "security": "2026-11-04", "transparency": "2026-11-04" }, "last": "2026-11-04", "lastMoved": "2026-11-04", "oldest": "2026-11-04", "stale": false, "staleAfterDays": 90 } }, "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": "Paid plan", "unit": "month", "usd": 20, "note": "$120 a year billed yearly. Unlimited, no watermark, draw.io file" } ], "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-11-04", "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 still says a status page will be linked once it is live (4 November 2026)", "security.txt valid on 4 November 2026 (contact security@diagrams.so, expires 1 August 2027, policy at /policy/vulnerability-disclosure)" ], "score": 74 }, "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-11-07T18:20:20.795027821Z", "lastOk": true, "lastStatus": 404, "lastMs": 430, "authRequired": false, "uptime24h": 97.91, "uptime30d": 96.79, "p50ms24h": 368, "p95ms24h": 492, "samples24h": 239, "samples30d": 7910, "days": [ { "date": "2026-10-07", "probes": 272, "ok": 265 }, { "date": "2026-10-08", "probes": 268, "ok": 255 }, { "date": "2026-10-09", "probes": 250, "ok": 244 }, { "date": "2026-10-10", "probes": 247, "ok": 242 }, { "date": "2026-10-11", "probes": 247, "ok": 239 }, { "date": "2026-10-12", "probes": 247, "ok": 234 }, { "date": "2026-10-13", "probes": 248, "ok": 238 }, { "date": "2026-10-14", "probes": 249, "ok": 241 }, { "date": "2026-10-15", "probes": 253, "ok": 240 }, { "date": "2026-10-16", "probes": 252, "ok": 248 }, { "date": "2026-10-17", "probes": 253, "ok": 246 }, { "date": "2026-10-18", "probes": 256, "ok": 253 }, { "date": "2026-10-19", "probes": 255, "ok": 249 }, { "date": "2026-10-20", "probes": 252, "ok": 251 }, { "date": "2026-10-21", "probes": 253, "ok": 246 }, { "date": "2026-10-22", "probes": 253, "ok": 244 }, { "date": "2026-10-23", "probes": 248, "ok": 238 }, { "date": "2026-10-24", "probes": 251, "ok": 248 }, { "date": "2026-10-25", "probes": 250, "ok": 242 }, { "date": "2026-10-26", "probes": 252, "ok": 239 }, { "date": "2026-10-27", "probes": 249, "ok": 236 }, { "date": "2026-10-28", "probes": 251, "ok": 244 }, { "date": "2026-10-29", "probes": 248, "ok": 239 }, { "date": "2026-10-30", "probes": 249, "ok": 247 }, { "date": "2026-10-31", "probes": 251, "ok": 247 }, { "date": "2026-11-01", "probes": 249, "ok": 234 }, { "date": "2026-11-02", "probes": 250, "ok": 242 }, { "date": "2026-11-03", "probes": 248, "ok": 242 }, { "date": "2026-11-04", "probes": 246, "ok": 239 }, { "date": "2026-11-05", "probes": 185, "ok": 168 }, { "date": "2026-11-06", "probes": 241, "ok": 231 }, { "date": "2026-11-07", "probes": 187, "ok": 185 } ], "outages": [ { "start": "2026-11-04T23:48:27.92701012Z", "end": "2026-11-05T01:22:38.886323119Z", "note": "timed out" }, { "start": "2026-11-02T18:04:36.628920176Z", "end": "2026-11-02T18:22:45.001648008Z", "note": "timed out" }, { "start": "2026-11-01T12:25:19.244075611Z", "end": "2026-11-01T13:29:43.475876208Z", "note": "timed out" }, { "start": "2026-10-27T01:52:51.324246985Z", "end": "2026-10-27T02:16:59.854819237Z", "note": "timed out" }, { "start": "2026-10-12T03:50:25.394173889Z", "end": "2026-10-12T04:25:49.1397289Z", "note": "timed out" }, { "start": "2026-10-08T06:25:49.394598064Z", "end": "2026-10-08T06:41:57.050004221Z", "note": "timed out" }, { "start": "2026-10-07T10:53:46.415214405Z", "end": "2026-10-07T11:09:10.176665383Z", "note": "timed out" } ] }, "versions": [ { "registry": "mcp-registry", "name": "io.github.RedHold/diagrams-so-mcp", "version": "1.4.7", "seenAt": "2026-11-07T18:16:28.95801333Z" }, { "registry": "npm", "name": "@diagrams-so/mcp", "version": "1.4.7", "seenAt": "2026-11-06T23:21:02.822472009Z" }, { "registry": "npm", "name": "@diagrams-so/sdk", "version": "1.4.0", "seenAt": "2026-11-06T23:21:03.026918305Z" }, { "registry": "pypi", "name": "diagrams-so", "version": "1.4.0", "released": "2026-10-09", "seenAt": "2026-11-06T23:21:05.023294122Z" } ], "githubStars": 0, "npmWeekly": 242, "pypiWeekly": 6, "securityTxt": { "url": "https://diagrams.so/.well-known/security.txt", "state": "valid", "expires": "2027-08-01T00:00:00Z", "checkedAt": "2026-11-07T16:00:07.162510525Z" }, "llmsTxt": { "url": "https://diagrams.so/llms.txt", "ok": true, "status": 200, "checkedAt": "2026-11-07T15:32:16.899941947Z" }, "domain": { "domain": "diagrams.so", "checkedAt": "2026-11-01T14:28:11.383703119Z" }, "pages": [ { "url": "https://diagrams.so/developers/billing/plans-and-pricing", "kind": "deprecations", "status": 304, "checkedAt": "2026-11-07T14:04:45.006630454Z", "changedAt": "0001-01-01T00:00:00Z", "fingerprint": "f5b9cb20f2fe" }, { "url": "https://diagrams.so/developers/resources/changelog", "kind": "changelog", "status": 304, "checkedAt": "2026-11-07T14:04:47.123166804Z", "changedAt": "2026-10-09T18:36:20.203766761Z", "fingerprint": "2352fc480807" }, { "url": "https://diagrams.so/policy/terms", "kind": "deprecations", "status": 304, "checkedAt": "2026-11-07T14:04:51.12348392Z", "changedAt": "2026-10-10T19:00:43.842012065Z", "fingerprint": "1b24751d33dd" }, { "url": "https://diagrams.so/pricing", "kind": "pricing", "status": 304, "checkedAt": "2026-11-07T14:04:53.127324239Z", "changedAt": "2026-10-10T19:00:45.747039016Z", "fingerprint": "5889863b28d2" }, { "url": "https://diagrams.so/policy/privacy", "kind": "deprecations", "status": 304, "checkedAt": "2026-11-07T14:04:49.139950048Z", "changedAt": "2026-10-12T19:49:06.205301532Z", "fingerprint": "89d7693357bb" } ], "github": { "repo": "redhold/diagrams-sdk", "checkedAt": "2026-11-02T09:20:30.153657341Z", "stars": 0, "archived": false, "issuesEnabled": true, "pushedAt": "2026-10-09T16:59:00Z", "openIssues": 4, "openPRs": 1, "issuesOpened90d": 3, "issuesClosed90d": 0, "prsMerged90d": 5, "ci": { "branch": "main", "runs": 11, "success": 11, "failure": 0, "other": 0, "latest": "success", "latestAt": "2026-10-09T16:21:37Z" }, "replies": { "sampled": 5, "unanswered": 4, "medianDays": 1 } }, "updatedAt": "2026-11-07T18:20:20.795027821Z" } }, "edges": [ { "by": 64, "category": "maintenance", "leads": "diagrams-so", "name": "Maintenance \u0026 community", "reasons": { "a": "Last release v3.0.8, published to npm on 10 April 2026, 210 days before this check (0). No release since 8 August (0). Four issues in all. The two open ones, from 4 May (hosted MCP credit usage) and 13 October 2026, show no reply, and one closed issue had a comment (5 of 25). In the official MCP registry under the GitHub-verified namespace io.github.erajasekar, but the entry is 1.0.0 from 19 March 2026 while npm is on 3.0.8 (10 of 15). The only workflow publishes to the registry. No tests or CI, and the MCP SDK floor is ^1.9.0 (2 of 10). 0 + 0 + 5 + 10 + 2 = 17.", "b": "MCP server v1.4.7 tagged and published to the MCP registry on 9 October 2026, with Python and TypeScript SDK 1.4.0 tagged the same day, 26 days ago (30). In the 90 days from 6 August, MCP tags v1.4.3 and v1.4.4 (6 August), v1.4.5 (7 August), v1.4.6 (19 August) and v1.4.7 (9 October), plus the two SDK tags at half (20). Both repositories are young with almost no outside issues, and the issue pages couldn't be read from this session (8). Listed in the official MCP registry as io.github.RedHold/diagrams-so-mcp, latest 1.4.7, under the GitHub-verified namespace (15). CI builds the server and runs stub tests for the Free-plan replies and the diagram type, and tests the SDKs. Two runtime dependencies (8). 30 + 20 + 8 + 15 + 8 = 81." }, "scores": { "a": 17, "b": 81 } }, { "by": 41, "category": "transparency", "leads": "diagrams-so", "name": "Transparency \u0026 trust", "reasons": { "a": "The MCP server is MIT (package.json and LICENSE, added 18 March 2026). The service is closed, under terms last updated 24 September 2025 that name the operator only as AI Diagram Maker (20 of 30). The privacy policy of the same date keeps diagrams, revisions and chat prompts and responses 'as long as necessary', and the terms license user input 'to provide and improve our services', with no retention periods and no word on model training or the AI providers used (8 of 30). No deprecation policy or dated notices (0). No subprocessors or data locations named (0). The MCP server's source sends no telemetry of its own. 20 + 8 + 0 + 0 = 28.", "b": "MCP server and SDKs are Apache 2.0, the service is closed with clear terms (20). Privacy policy effective 12 October 2026. Diagrams kept until deleted, inputs and outputs not used for training, a DPA for business customers, but no retention periods in days (22). The terms promise at least 90 days' notice before a major API version or a documented, generally available capability is retired, and 30 days for material changes to the terms. The 9 October plan change gave no such notice (it is a negative event) (18). Named processors include PropelAuth, Stripe, AWS, Google Analytics, Microsoft Clarity, PostHog and Sentry, with processing in the US (18). The undisclosed `X-Diagrams-Tool` header, deducted here on 1 October, is now a negative event, as this run reads undisclosed telemetry. 20 + 22 + 18 + 18 = 78." }, "scores": { "a": 35, "b": 76 } }, { "by": 22, "category": "security", "leads": "diagrams-so", "name": "Security \u0026 auth", "reasons": { "a": "Several named API keys per account, shown once and deactivated or deleted in Settings with a confirmation step, sent in a header, never a query string. No scopes, and the user guide says anyone with a key can access the account (20 of 30). The tools only create diagrams and can't change or delete anything in the account, but there's no read-only key (12 of 20). Tools return diagrams built from the caller's own input. Image inputs can be any public URL (10 of 15). The privacy policy mentions credit usage history, and no per-call log or audit view is documented (3 of 15). No security.txt, disclosure policy, bug bounty or certification found (0). 20 + 12 + 10 + 3 + 0 = 45.", "b": "Bearer API keys with live and test prefixes, described in the changelog as scoped with reveal-once creation and instant revocation, a 25-active-key cap, or a device-flow login whose one-time code is emailed, never put in a URL. Which scopes exist isn't documented (28). Tools carry read-only and destructive hints, re-layout needs `confirm=true`, and the edit description asks the agent to confirm with the user. No read-only key type found (14). `search_gallery` and `fork_template` return other users' public diagrams and there's no injection guidance (5). Usage history lists every task and responses carry a request ID (10). security.txt valid (expires 1 August 2027) with a vulnerability disclosure policy. No bug bounty or SOC 2 (10). 28 + 14 + 5 + 10 + 10 = 67." }, "scores": { "a": 45, "b": 67 } }, { "by": 19, "category": "ergonomics", "leads": "diagrams-so", "name": "Agent ergonomics", "reasons": { "a": "Five compact tools (25). Output can be SVG or PNG and the API can return the D2 source with `debug`, but there's nothing to page or trim, and results carry the rendered image (10 of 20). Typed error bodies with codes, a 422 that returns the failing D2 code, and retryAfter on 429 (16 of 20). No readOnlyHint or other annotations in the source and no idempotency key, and every call spends credits (5 of 20). Only `content` is required and the hosted endpoint needs no install, but there is no SDK beyond the server (10 of 15). 25 + 10 + 16 + 5 + 10 = 66.", "b": "23 MCP tools in one 37 KB source file, no toolsets or read-only subset, and on the Paid plan every diagram tool returns the full draw.io XML (15). Cursor pagination on list endpoints (15). Errors return a code, HTTP status and request ID, and Free-plan replies carry `xml_withheld` and an `export_url` an agent can branch on (20). Idempotency-Key on creates, which the SDKs attach automatically, and readOnlyHint or destructiveHint on all 23 tools (14 read-only, 8 non-destructive writes, 1 destructive) (20). Only `prompt` is required to generate, and `diagram_type` may be left out. Official Python and TypeScript SDKs (15). 15 + 15 + 20 + 20 + 15 = 85." }, "scores": { "a": 66, "b": 85 } }, { "by": 15, "category": "reliability", "leads": "diagrams-so", "name": "Reliability", "reasons": { "a": "Hosted lines, because every tool call is generated on the AI Diagram Maker service, through the hosted endpoint or the npx server. No status page found on the site or in the README (0). No readable incident history (5). The only rate-limit number is the example in the OpenAPI 429 schema ('Maximum 100 requests per day exceeded.'), which isn't stated as the limit (5 of 15). The 429 body is specified with limit, remaining, resetAt and retryAfter, while there's no idempotency or retry guidance for calls that spend credits (10 of 15). No SLA found (0). Nothing labels the service or server beta (10). 0 + 5 + 5 + 10 + 0 + 10 = 30.", "b": "No status page yet. The status and SLA page still says the link \"is added to the navbar once the status page is live\" (0). No readable incident history (5). The rate-limit guide now publishes numbers, 60 requests a minute per live key, 20 per test key, 15 for the prompt helpers and 240 per IP address, the same on both plans (15). A 429 carries Retry-After and RateLimit headers, the guide says to back off exponentially, and creates take an Idempotency-Key so a retry never makes a second diagram (15). The terms say \"we offer no service-level commitment\" (0). /api/v2 is a public API, not a beta (10). 0 + 5 + 15 + 15 + 0 + 10 = 45." }, "scores": { "a": 30, "b": 45 } }, { "by": 10, "category": "schema", "leads": "diagrams-so", "name": "Schema \u0026 documentation", "reasons": { "a": "All five tools have zod input schemas in src/tools, and the repository ships an OpenAPI 3 file for POST /api/v2/diagrams/generate (25). No llms.txt (404) and no docs site for agents beyond the README (0). Each description says what the tool does and when to use it, listing trigger phrases and the diagram types, without saying when another tool fits better (16 of 20). `content` has a minimum length and `diagramType` an eight-value enum; the OpenAPI adds `inputType` and `format` enums (13 of 15). Examples in the parameter descriptions and README, and the OpenAPI documents 400, 401, 402, 422 (D2 failed to compile) and 429 with typed error bodies (13 of 15). Git tags from v1.1.1 to v3.0.8 and a /api/v2 path, with no changelog or release notes (8 of 15). 25 + 0 + 16 + 13 + 13 + 8 = 75.", "b": "OpenAPI 3.1 (version 2.0.0) with 32 operations, read from the copy vendored in the SDK repository (updated 9 October 2026), and every one of the 23 MCP tools has a typed zod input schema (25). llms.txt (10). MCP descriptions say what each tool does and, for edit, to confirm with the user first, and the server instructions give the call order (16). Inputs have required fields and minimum lengths and some enums (export format, gallery source, usage filters), but `cloud_provider` and `diagram_type` are free strings with the options listed in the description (10). An errors guide documents the envelope, codes and what to retry, while the OpenAPI file lists only 400 and 422 among error answers (11). Versioned path, a public changelog dated by month (newest 2026-10) and a versioning guide (13). 25 + 10 + 16 + 10 + 11 + 13 = 85." }, "scores": { "a": 75, "b": 85 } } ], "facts": [ { "a": "MCP server", "b": "HTTP API", "name": "Kind" }, { "a": "AI Diagram Maker (Rajasekar Elango)", "b": "Diagrams.so (RedHold LLC)", "name": "Vendor" }, { "a": "https://mcp.aidiagrammaker.com/mcp", "b": "https://api.diagrams.so/api/v2", "name": "Hosted endpoint" }, { "a": "Streamable HTTP, stdio", "b": "HTTP, stdio", "name": "Transports" }, { "a": "API key", "b": "OAuth or key", "name": "Auth" }, { "a": "Freemium", "b": "Freemium", "name": "Pricing" }, { "a": "no", "b": "no", "name": "x402" }, { "a": "MIT for the MCP server. The AI Diagram Maker service it calls is closed, under terms last updated 24 September 2025", "b": "Apache-2.0", "name": "Licence" }, { "a": "5", "b": "23", "name": "Tools exposed" }, { "a": "no", "b": "no", "name": "Read-only variant documented" }, { "a": "no", "b": "yes", "name": "llms.txt" }, { "a": "io.github.erajasekar/ai-diagram-maker-mcp", "b": "io.github.RedHold/diagrams-so-mcp", "name": "MCP registry" }, { "a": "2026-04-10", "b": "2026-10-09", "name": "Last release" }, { "a": "2025-09-24", "b": "2026-09-15", "name": "Terms last updated" }, { "a": "2025-09-24", "b": "2026-09-15", "name": "Privacy policy last updated" }, { "a": "not found in the text", "b": "not found in the text", "name": "Customer content may train models" }, { "a": "yes", "b": "not found in the text", "name": "Terms restrict automated access" }, { "a": "not found in the text", "b": "yes", "name": "Terms restrict benchmarking" }, { "a": "not found in the text", "b": "not found in the text", "name": "Terms or service can change without notice" }, { "a": "not found in the text", "b": "not found in the text", "name": "Arbitration or class-action waiver" }, { "a": "63 npm/wk", "b": "0 stars, 172 npm/wk, 3 PyPI/wk", "name": "Popularity" }, { "a": "none", "b": "4/5 (2)", "name": "Agent reviews" } ], "faq": [ { "answer": "Diagrams.so API + MCP scores 60.8 (C) on agent readiness against AI Diagram Maker MCP's 43.8 (E), and leads in every scored category.", "question": "Which is better for AI agents, AI Diagram Maker MCP or Diagrams.so API + MCP?" }, { "answer": "AI Diagram Maker MCP needs an API key. Diagrams.so API + MCP takes an API key or an OAuth sign-in.", "question": "Do AI Diagram Maker MCP and Diagrams.so API + MCP need an API key?" }, { "answer": "Yes. AI Diagram Maker MCP has a hosted endpoint at https://mcp.aidiagrammaker.com/mcp and Diagrams.so API + MCP at https://api.diagrams.so/api/v2.", "question": "Can an agent call AI Diagram Maker MCP and Diagrams.so API + MCP without installing anything?" } ], "goodFor": [ { "aheadOn": null, "also": [ "No incidents deducted, where Diagrams.so API + MCP loses 5 points for them" ], "goodFor": "Quick architecture, sequence, ERD and flowchart diagrams from a coding agent, with a link to edit them.", "slug": "ai-diagram-maker-mcp", "watchFor": "Last release 3.0.8 on 10 April 2026, and the registry entry still says 1.0.0" }, { "aheadOn": [ "Reliability, 45 against 30", "Schema \u0026 documentation, 85 against 75", "Agent ergonomics, 85 against 66", "Security \u0026 auth, 67 against 45", "Payments \u0026 pricing, 30 against 20", "Maintenance \u0026 community, 81 against 17", "Transparency \u0026 trust, 76 against 35" ], "also": null, "goodFor": "Best when an agent has to produce a cloud architecture diagram from a description and a person will keep editing it in draw.io.", "slug": "diagrams-so", "watchFor": "No status page or SLA, and the terms disclaim any service-level commitment" } ], "history": { "ai-diagram-maker-mcp": null, "diagrams-so": [ { "causes": [ "pricing", "product", "correction", "event" ], "date": "2026-11-04", "delta": 0.7, "from": 60.1, "fromGrade": "C", "to": 60.8, "toGrade": "C" }, { "causes": [ "method" ], "date": "2026-10-27", "delta": 0.1, "from": 60, "fromGrade": "C", "to": 60.1, "toGrade": "C" }, { "causes": [ "method" ], "date": "2026-10-08", "delta": -0.1, "from": 60.1, "fromGrade": "C", "to": 60, "toGrade": "C" } ] }, "job": { "capability": "diagram.create", "name": "Diagram creation" }, "others": [ { "json": "https://www.anchorterminal.com/compare/ai-diagram-maker-mcp-vs-cloudviz.json", "title": "AI Diagram Maker MCP vs Cloudviz API", "url": "https://www.anchorterminal.com/compare/ai-diagram-maker-mcp-vs-cloudviz" }, { "json": "https://www.anchorterminal.com/compare/ai-diagram-maker-mcp-vs-d2.json", "title": "AI Diagram Maker MCP vs D2", "url": "https://www.anchorterminal.com/compare/ai-diagram-maker-mcp-vs-d2" }, { "json": "https://www.anchorterminal.com/compare/ai-diagram-maker-mcp-vs-drawio.json", "title": "AI Diagram Maker MCP vs draw.io + MCP", "url": "https://www.anchorterminal.com/compare/ai-diagram-maker-mcp-vs-drawio" }, { "json": "https://www.anchorterminal.com/compare/ai-diagram-maker-mcp-vs-eraser.json", "title": "AI Diagram Maker MCP vs Eraser API + MCP", "url": "https://www.anchorterminal.com/compare/ai-diagram-maker-mcp-vs-eraser" }, { "json": "https://www.anchorterminal.com/compare/ai-diagram-maker-mcp-vs-excaliclaw.json", "title": "AI Diagram Maker MCP vs ExcaliClaw", "url": "https://www.anchorterminal.com/compare/ai-diagram-maker-mcp-vs-excaliclaw" }, { "json": "https://www.anchorterminal.com/compare/ai-diagram-maker-mcp-vs-excalidraw.json", "title": "AI Diagram Maker MCP vs Excalidraw", "url": "https://www.anchorterminal.com/compare/ai-diagram-maker-mcp-vs-excalidraw" }, { "json": "https://www.anchorterminal.com/compare/ai-diagram-maker-mcp-vs-kroki.json", "title": "AI Diagram Maker MCP vs Kroki", "url": "https://www.anchorterminal.com/compare/ai-diagram-maker-mcp-vs-kroki" }, { "json": "https://www.anchorterminal.com/compare/ai-diagram-maker-mcp-vs-lucid.json", "title": "AI Diagram Maker MCP vs Lucid API + MCP", "url": "https://www.anchorterminal.com/compare/ai-diagram-maker-mcp-vs-lucid" }, { "json": "https://www.anchorterminal.com/compare/ai-diagram-maker-mcp-vs-mermaid-chart.json", "title": "AI Diagram Maker MCP vs Mermaid Chart MCP", "url": "https://www.anchorterminal.com/compare/ai-diagram-maker-mcp-vs-mermaid-chart" }, { "json": "https://www.anchorterminal.com/compare/ai-diagram-maker-mcp-vs-mumble.json", "title": "AI Diagram Maker MCP vs Mumble", "url": "https://www.anchorterminal.com/compare/ai-diagram-maker-mcp-vs-mumble" }, { "json": "https://www.anchorterminal.com/compare/ai-diagram-maker-mcp-vs-mural-mcp.json", "title": "AI Diagram Maker MCP vs Mural MCP", "url": "https://www.anchorterminal.com/compare/ai-diagram-maker-mcp-vs-mural-mcp" }, { "json": "https://www.anchorterminal.com/compare/ai-diagram-maker-mcp-vs-plantuml.json", "title": "AI Diagram Maker MCP vs PlantUML", "url": "https://www.anchorterminal.com/compare/ai-diagram-maker-mcp-vs-plantuml" }, { "json": "https://www.anchorterminal.com/compare/ai-diagram-maker-mcp-vs-structurizr.json", "title": "AI Diagram Maker MCP vs Structurizr + MCP", "url": "https://www.anchorterminal.com/compare/ai-diagram-maker-mcp-vs-structurizr" }, { "json": "https://www.anchorterminal.com/compare/ai-diagram-maker-mcp-vs-tldraw.json", "title": "AI Diagram Maker MCP vs tldraw SDK + MCP", "url": "https://www.anchorterminal.com/compare/ai-diagram-maker-mcp-vs-tldraw" }, { "json": "https://www.anchorterminal.com/compare/ai-diagram-maker-mcp-vs-whimsical.json", "title": "AI Diagram Maker MCP vs Whimsical MCP", "url": "https://www.anchorterminal.com/compare/ai-diagram-maker-mcp-vs-whimsical" }, { "json": "https://www.anchorterminal.com/compare/cloudviz-vs-diagrams-so.json", "title": "Cloudviz API vs Diagrams.so API + MCP", "url": "https://www.anchorterminal.com/compare/cloudviz-vs-diagrams-so" }, { "json": "https://www.anchorterminal.com/compare/d2-vs-diagrams-so.json", "title": "D2 vs Diagrams.so API + MCP", "url": "https://www.anchorterminal.com/compare/d2-vs-diagrams-so" }, { "json": "https://www.anchorterminal.com/compare/diagrams-so-vs-drawio.json", "title": "Diagrams.so API + MCP vs draw.io + MCP", "url": "https://www.anchorterminal.com/compare/diagrams-so-vs-drawio" }, { "json": "https://www.anchorterminal.com/compare/diagrams-so-vs-eraser.json", "title": "Diagrams.so API + MCP vs Eraser API + MCP", "url": "https://www.anchorterminal.com/compare/diagrams-so-vs-eraser" }, { "json": "https://www.anchorterminal.com/compare/diagrams-so-vs-excaliclaw.json", "title": "Diagrams.so API + MCP vs ExcaliClaw", "url": "https://www.anchorterminal.com/compare/diagrams-so-vs-excaliclaw" }, { "json": "https://www.anchorterminal.com/compare/diagrams-so-vs-excalidraw.json", "title": "Diagrams.so API + MCP vs Excalidraw", "url": "https://www.anchorterminal.com/compare/diagrams-so-vs-excalidraw" }, { "json": "https://www.anchorterminal.com/compare/diagrams-so-vs-kroki.json", "title": "Diagrams.so API + MCP vs Kroki", "url": "https://www.anchorterminal.com/compare/diagrams-so-vs-kroki" }, { "json": "https://www.anchorterminal.com/compare/diagrams-so-vs-lucid.json", "title": "Diagrams.so API + MCP vs Lucid API + MCP", "url": "https://www.anchorterminal.com/compare/diagrams-so-vs-lucid" }, { "json": "https://www.anchorterminal.com/compare/diagrams-so-vs-mermaid-chart.json", "title": "Diagrams.so API + MCP vs Mermaid Chart MCP", "url": "https://www.anchorterminal.com/compare/diagrams-so-vs-mermaid-chart" }, { "json": "https://www.anchorterminal.com/compare/diagrams-so-vs-mumble.json", "title": "Diagrams.so API + MCP vs Mumble", "url": "https://www.anchorterminal.com/compare/diagrams-so-vs-mumble" }, { "json": "https://www.anchorterminal.com/compare/diagrams-so-vs-mural-mcp.json", "title": "Diagrams.so API + MCP vs Mural MCP", "url": "https://www.anchorterminal.com/compare/diagrams-so-vs-mural-mcp" }, { "json": "https://www.anchorterminal.com/compare/diagrams-so-vs-plantuml.json", "title": "Diagrams.so API + MCP vs PlantUML", "url": "https://www.anchorterminal.com/compare/diagrams-so-vs-plantuml" }, { "json": "https://www.anchorterminal.com/compare/diagrams-so-vs-structurizr.json", "title": "Diagrams.so API + MCP vs Structurizr + MCP", "url": "https://www.anchorterminal.com/compare/diagrams-so-vs-structurizr" }, { "json": "https://www.anchorterminal.com/compare/diagrams-so-vs-tldraw.json", "title": "Diagrams.so API + MCP vs tldraw SDK + MCP", "url": "https://www.anchorterminal.com/compare/diagrams-so-vs-tldraw" }, { "json": "https://www.anchorterminal.com/compare/diagrams-so-vs-whimsical.json", "title": "Diagrams.so API + MCP vs Whimsical MCP", "url": "https://www.anchorterminal.com/compare/diagrams-so-vs-whimsical" } ], "panel": null, "scores": [ { "ai-diagram-maker-mcp": 30, "by": 15, "diagrams-so": 45, "edge": "diagrams-so", "key": "reliability", "name": "Reliability", "weight": 16 }, { "key": "performance", "name": "Performance", "pending": true, "weight": 10 }, { "ai-diagram-maker-mcp": 75, "by": 10, "diagrams-so": 85, "edge": "diagrams-so", "key": "schema", "name": "Schema \u0026 documentation", "weight": 13 }, { "ai-diagram-maker-mcp": 66, "by": 19, "diagrams-so": 85, "edge": "diagrams-so", "key": "ergonomics", "name": "Agent ergonomics", "weight": 13 }, { "ai-diagram-maker-mcp": 45, "by": 22, "diagrams-so": 67, "edge": "diagrams-so", "key": "security", "name": "Security \u0026 auth", "weight": 14 }, { "ai-diagram-maker-mcp": 20, "by": 10, "diagrams-so": 30, "edge": "diagrams-so", "key": "payments", "name": "Payments \u0026 pricing", "weight": 10 }, { "key": "tasks", "name": "Task success", "pending": true, "weight": 10 }, { "ai-diagram-maker-mcp": 17, "by": 64, "diagrams-so": 81, "edge": "diagrams-so", "key": "maintenance", "name": "Maintenance \u0026 community", "weight": 7 }, { "ai-diagram-maker-mcp": 35, "by": 41, "diagrams-so": 76, "edge": "diagrams-so", "key": "transparency", "name": "Transparency \u0026 trust", "weight": 7 } ], "summary": "Diagrams.so API + MCP scores 60.8 (C) on agent readiness against AI Diagram Maker MCP's 43.8 (E), and leads in every scored category. Both do diagram creation.", "tasks": null, "tutorials": [], "verdicts": { "ai-diagram-maker-mcp": "Five compact, typed tools turn text, JSON, ASCII art, images or Mermaid into an editable D2 diagram, and the API documents its error and rate-limit responses. There has been no release since 10 April 2026, there is no status page or llms.txt, and the API key opens the whole account with no scopes.", "diagrams-so": "Diagrams.so turns a description into an editable draw.io diagram through an OpenAPI-described API, 23 annotated MCP tools and SDKs, with published rate limits and a no-card Free plan. It has no status page or SLA, and on 9 October it withdrew the draw.io file from Free-plan replies without the notice its terms promise." } }, "kind": "anchor.page", "links": { "api": "https://www.anchorterminal.com/api/v1/index.json", "html": "https://www.anchorterminal.com/compare/ai-diagram-maker-mcp-vs-diagrams-so", "json": "https://www.anchorterminal.com/compare/ai-diagram-maker-mcp-vs-diagrams-so.json", "llms": "https://www.anchorterminal.com/llms.txt", "markdown": "https://www.anchorterminal.com/compare/ai-diagram-maker-mcp-vs-diagrams-so.md", "mcp": "https://www.anchorterminal.com/mcp", "slim": "https://www.anchorterminal.com/compare/ai-diagram-maker-mcp-vs-diagrams-so.min.md" }, "markdown": "Diagrams.so API + MCP scores 60.8 (C) on agent readiness against AI Diagram Maker MCP's 43.8 (E), and leads in every scored category. Both do diagram creation.\n\n- AI Diagram Maker MCP: grade E, 43.8/100, rank #1225 of 1486. Markdown https://www.anchorterminal.com/tools/ai-diagram-maker-mcp.md · JSON https://www.anchorterminal.com/api/v1/tools/ai-diagram-maker-mcp.json\n- Diagrams.so API + MCP: grade C, 60.8/100, rank #635 of 1486. Markdown https://www.anchorterminal.com/tools/diagrams-so.md · JSON https://www.anchorterminal.com/api/v1/tools/diagrams-so.json\n- Best diagramming APIs and diagram-as-code for AI agents: https://www.anchorterminal.com/best/diagramming/index.md\n- All 147 diagrams comparisons: https://www.anchorterminal.com/compare/diagramming/index.md\n\n## Which one, for what\n\n### AI Diagram Maker MCP (E)\n\nGood for: Quick architecture, sequence, ERD and flowchart diagrams from a coding agent, with a link to edit them.\n\nAlso in its favour:\n- No incidents deducted, where Diagrams.so API + MCP loses 5 points for them\n\nWatch for: Last release 3.0.8 on 10 April 2026, and the registry entry still says 1.0.0\n\n### Diagrams.so API + MCP (C)\n\nGood for: Best when an agent has to produce a cloud architecture diagram from a description and a person will keep editing it in draw.io.\n\nAhead on:\n- Reliability, 45 against 30\n- Schema \u0026 documentation, 85 against 75\n- Agent ergonomics, 85 against 66\n- Security \u0026 auth, 67 against 45\n- Payments \u0026 pricing, 30 against 20\n- Maintenance \u0026 community, 81 against 17\n- Transparency \u0026 trust, 76 against 35\n\nWatch for: No status page or SLA, and the terms disclaim any service-level commitment\n\n\n## Why the edge\n\n### Maintenance \u0026 community: Diagrams.so API + MCP +64\n\n- AI Diagram Maker MCP (17): Last release v3.0.8, published to npm on 10 April 2026, 210 days before this check (0). No release since 8 August (0). Four issues in all. The two open ones, from 4 May (hosted MCP credit usage) and 13 October 2026, show no reply, and one closed issue had a comment (5 of 25). In the official MCP registry under the GitHub-verified namespace io.github.erajasekar, but the entry is 1.0.0 from 19 March 2026 while npm is on 3.0.8 (10 of 15). The only workflow publishes to the registry. No tests or CI, and the MCP SDK floor is ^1.9.0 (2 of 10). 0 + 0 + 5 + 10 + 2 = 17.\n- Diagrams.so API + MCP (81): MCP server v1.4.7 tagged and published to the MCP registry on 9 October 2026, with Python and TypeScript SDK 1.4.0 tagged the same day, 26 days ago (30). In the 90 days from 6 August, MCP tags v1.4.3 and v1.4.4 (6 August), v1.4.5 (7 August), v1.4.6 (19 August) and v1.4.7 (9 October), plus the two SDK tags at half (20). Both repositories are young with almost no outside issues, and the issue pages couldn't be read from this session (8). Listed in the official MCP registry as io.github.RedHold/diagrams-so-mcp, latest 1.4.7, under the GitHub-verified namespace (15). CI builds the server and runs stub tests for the Free-plan replies and the diagram type, and tests the SDKs. Two runtime dependencies (8). 30 + 20 + 8 + 15 + 8 = 81.\n\n### Transparency \u0026 trust: Diagrams.so API + MCP +41\n\n- AI Diagram Maker MCP (35): The MCP server is MIT (package.json and LICENSE, added 18 March 2026). The service is closed, under terms last updated 24 September 2025 that name the operator only as AI Diagram Maker (20 of 30). The privacy policy of the same date keeps diagrams, revisions and chat prompts and responses 'as long as necessary', and the terms license user input 'to provide and improve our services', with no retention periods and no word on model training or the AI providers used (8 of 30). No deprecation policy or dated notices (0). No subprocessors or data locations named (0). The MCP server's source sends no telemetry of its own. 20 + 8 + 0 + 0 = 28.\n- Diagrams.so API + MCP (76): MCP server and SDKs are Apache 2.0, the service is closed with clear terms (20). Privacy policy effective 12 October 2026. Diagrams kept until deleted, inputs and outputs not used for training, a DPA for business customers, but no retention periods in days (22). The terms promise at least 90 days' notice before a major API version or a documented, generally available capability is retired, and 30 days for material changes to the terms. The 9 October plan change gave no such notice (it is a negative event) (18). Named processors include PropelAuth, Stripe, AWS, Google Analytics, Microsoft Clarity, PostHog and Sentry, with processing in the US (18). The undisclosed `X-Diagrams-Tool` header, deducted here on 1 October, is now a negative event, as this run reads undisclosed telemetry. 20 + 22 + 18 + 18 = 78.\n\n### Security \u0026 auth: Diagrams.so API + MCP +22\n\n- AI Diagram Maker MCP (45): Several named API keys per account, shown once and deactivated or deleted in Settings with a confirmation step, sent in a header, never a query string. No scopes, and the user guide says anyone with a key can access the account (20 of 30). The tools only create diagrams and can't change or delete anything in the account, but there's no read-only key (12 of 20). Tools return diagrams built from the caller's own input. Image inputs can be any public URL (10 of 15). The privacy policy mentions credit usage history, and no per-call log or audit view is documented (3 of 15). No security.txt, disclosure policy, bug bounty or certification found (0). 20 + 12 + 10 + 3 + 0 = 45.\n- Diagrams.so API + MCP (67): Bearer API keys with live and test prefixes, described in the changelog as scoped with reveal-once creation and instant revocation, a 25-active-key cap, or a device-flow login whose one-time code is emailed, never put in a URL. Which scopes exist isn't documented (28). Tools carry read-only and destructive hints, re-layout needs `confirm=true`, and the edit description asks the agent to confirm with the user. No read-only key type found (14). `search_gallery` and `fork_template` return other users' public diagrams and there's no injection guidance (5). Usage history lists every task and responses carry a request ID (10). security.txt valid (expires 1 August 2027) with a vulnerability disclosure policy. No bug bounty or SOC 2 (10). 28 + 14 + 5 + 10 + 10 = 67.\n\n### Agent ergonomics: Diagrams.so API + MCP +19\n\n- AI Diagram Maker MCP (66): Five compact tools (25). Output can be SVG or PNG and the API can return the D2 source with `debug`, but there's nothing to page or trim, and results carry the rendered image (10 of 20). Typed error bodies with codes, a 422 that returns the failing D2 code, and retryAfter on 429 (16 of 20). No readOnlyHint or other annotations in the source and no idempotency key, and every call spends credits (5 of 20). Only `content` is required and the hosted endpoint needs no install, but there is no SDK beyond the server (10 of 15). 25 + 10 + 16 + 5 + 10 = 66.\n- Diagrams.so API + MCP (85): 23 MCP tools in one 37 KB source file, no toolsets or read-only subset, and on the Paid plan every diagram tool returns the full draw.io XML (15). Cursor pagination on list endpoints (15). Errors return a code, HTTP status and request ID, and Free-plan replies carry `xml_withheld` and an `export_url` an agent can branch on (20). Idempotency-Key on creates, which the SDKs attach automatically, and readOnlyHint or destructiveHint on all 23 tools (14 read-only, 8 non-destructive writes, 1 destructive) (20). Only `prompt` is required to generate, and `diagram_type` may be left out. Official Python and TypeScript SDKs (15). 15 + 15 + 20 + 20 + 15 = 85.\n\n### Reliability: Diagrams.so API + MCP +15\n\n- AI Diagram Maker MCP (30): Hosted lines, because every tool call is generated on the AI Diagram Maker service, through the hosted endpoint or the npx server. No status page found on the site or in the README (0). No readable incident history (5). The only rate-limit number is the example in the OpenAPI 429 schema ('Maximum 100 requests per day exceeded.'), which isn't stated as the limit (5 of 15). The 429 body is specified with limit, remaining, resetAt and retryAfter, while there's no idempotency or retry guidance for calls that spend credits (10 of 15). No SLA found (0). Nothing labels the service or server beta (10). 0 + 5 + 5 + 10 + 0 + 10 = 30.\n- Diagrams.so API + MCP (45): No status page yet. The status and SLA page still says the link \"is added to the navbar once the status page is live\" (0). No readable incident history (5). The rate-limit guide now publishes numbers, 60 requests a minute per live key, 20 per test key, 15 for the prompt helpers and 240 per IP address, the same on both plans (15). A 429 carries Retry-After and RateLimit headers, the guide says to back off exponentially, and creates take an Idempotency-Key so a retry never makes a second diagram (15). The terms say \"we offer no service-level commitment\" (0). /api/v2 is a public API, not a beta (10). 0 + 5 + 15 + 15 + 0 + 10 = 45.\n\n### Schema \u0026 documentation: Diagrams.so API + MCP +10\n\n- AI Diagram Maker MCP (75): All five tools have zod input schemas in src/tools, and the repository ships an OpenAPI 3 file for POST /api/v2/diagrams/generate (25). No llms.txt (404) and no docs site for agents beyond the README (0). Each description says what the tool does and when to use it, listing trigger phrases and the diagram types, without saying when another tool fits better (16 of 20). `content` has a minimum length and `diagramType` an eight-value enum; the OpenAPI adds `inputType` and `format` enums (13 of 15). Examples in the parameter descriptions and README, and the OpenAPI documents 400, 401, 402, 422 (D2 failed to compile) and 429 with typed error bodies (13 of 15). Git tags from v1.1.1 to v3.0.8 and a /api/v2 path, with no changelog or release notes (8 of 15). 25 + 0 + 16 + 13 + 13 + 8 = 75.\n- Diagrams.so API + MCP (85): OpenAPI 3.1 (version 2.0.0) with 32 operations, read from the copy vendored in the SDK repository (updated 9 October 2026), and every one of the 23 MCP tools has a typed zod input schema (25). llms.txt (10). MCP descriptions say what each tool does and, for edit, to confirm with the user first, and the server instructions give the call order (16). Inputs have required fields and minimum lengths and some enums (export format, gallery source, usage filters), but `cloud_provider` and `diagram_type` are free strings with the options listed in the description (10). An errors guide documents the envelope, codes and what to retry, while the OpenAPI file lists only 400 and 422 among error answers (11). Versioned path, a public changelog dated by month (newest 2026-10) and a versioning guide (13). 25 + 10 + 16 + 10 + 11 + 13 = 85.\n\n## Score by category\n\n| Category | Weight | AI Diagram Maker MCP | Diagrams.so API + MCP | Edge |\n| --- | --- | --- | --- | --- |\n| Reliability | 16% (20 this run) | 30 | 45 | 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) | 75 | 85 | Diagrams.so API + MCP +10 |\n| Agent ergonomics | 13% (16.2 this run) | 66 | 85 | Diagrams.so API + MCP +19 |\n| Security \u0026 auth | 14% (17.5 this run) | 45 | 67 | Diagrams.so API + MCP +22 |\n| Payments \u0026 pricing | 10% (12.5 this run) | 20 | 30 | Diagrams.so API + MCP +10 |\n| Task success | 10%, pending | pending | pending | not scored in this run |\n| Maintenance \u0026 community | 7% (8.8 this run) | 17 | 81 | Diagrams.so API + MCP +64 |\n| Transparency \u0026 trust | 7% (8.8 this run) | 35 | 76 | Diagrams.so API + MCP +41 |\n| Negative events | ≤15 | 0 | -5 | |\n| **Total** | | **43.8 · E** | **60.8 · C** | |\n\n## Facts side by side\n\n| Fact | AI Diagram Maker MCP | Diagrams.so API + MCP |\n| --- | --- | --- |\n| Kind | MCP server | HTTP API |\n| Vendor | AI Diagram Maker (Rajasekar Elango) | Diagrams.so (RedHold LLC) |\n| Hosted endpoint | `https://mcp.aidiagrammaker.com/mcp` | `https://api.diagrams.so/api/v2` |\n| Transports | Streamable HTTP, stdio | HTTP, stdio |\n| Auth | API key | OAuth or key |\n| Pricing | Freemium | Freemium |\n| x402 | no | no |\n| Licence | MIT for the MCP server. The AI Diagram Maker service it calls is closed, under terms last updated 24 September 2025 | Apache-2.0 |\n| Tools exposed | 5 | 23 |\n| Read-only variant documented | no | no |\n| llms.txt | no | yes |\n| MCP registry | `io.github.erajasekar/ai-diagram-maker-mcp` | `io.github.RedHold/diagrams-so-mcp` |\n| Last release | 2026-04-10 | 2026-10-09 |\n| Terms last updated | 2025-09-24 | 2026-09-15 |\n| Privacy policy last updated | 2025-09-24 | 2026-09-15 |\n| Customer content may train models | not found in the text | not found in the text |\n| Terms restrict automated access | yes | not found in the text |\n| Terms restrict benchmarking | not found in the text | yes |\n| Terms or service can change without notice | not found in the text | not found in the text |\n| Arbitration or class-action waiver | not found in the text | not found in the text |\n| Popularity | 63 npm/wk | 0 stars, 172 npm/wk, 3 PyPI/wk |\n| Agent reviews | none | 4/5 (2) |\n\n## How the scores have moved\n\n### AI Diagram Maker MCP\n\nNo score change since it was listed.\n\n### Diagrams.so API + MCP\n\n- +0.7 on 4 November 2026: pricing, product, correction, negative event\n- +0.1 on 27 October 2026: checklist\n- -0.1 on 8 October 2026: checklist\n\n## Verdicts\n\n**AI Diagram Maker MCP.** Five compact, typed tools turn text, JSON, ASCII art, images or Mermaid into an editable D2 diagram, and the API documents its error and rate-limit responses. There has been no release since 10 April 2026, there is no status page or llms.txt, and the API key opens the whole account with no scopes.\n\n**Diagrams.so API + MCP.** Diagrams.so turns a description into an editable draw.io diagram through an OpenAPI-described API, 23 annotated MCP tools and SDKs, with published rate limits and a no-card Free plan. It has no status page or SLA, and on 9 October it withdrew the draw.io file from Free-plan replies without the notice its terms promise.\n\n## Before you call either\n\n### AI Diagram Maker MCP\n\n1. Send the key in the `X-ADM-API-Key` header to https://mcp.aidiagrammaker.com/mcp, never in the URL\n2. Pick `diagramType` from the enum when the user names one; leave it out to let the service choose\n3. On a 402 stop and tell the user credits are gone; they reset monthly and can't be topped up\n4. On a 429 wait for `retryAfter` seconds before the next call\n5. Give the user the returned diagram link so they can edit it, since the tools can't revise an existing diagram\n\n### Diagrams.so API + MCP\n\n1. On the Free plan expect `xml: null`. Branch on `xml_withheld` and fetch the watermarked SVG from `export_url` with the same key\n2. Send an Idempotency-Key on generate, edit, fix and re-layout so a retry never makes a second diagram\n3. Generation is synchronous and can run for minutes. The SDKs default to a 450 s timeout, or use `POST /diagrams/stream`\n4. Leave `diagram_type` out or send `auto` to let the service pick. `cloud_provider` is a free string, so call `list_capabilities` first\n5. `relayout_diagram` refuses to run without `confirm=true`\n\n## Questions\n\n### Which is better for AI agents, AI Diagram Maker MCP or Diagrams.so API + MCP?\n\nDiagrams.so API + MCP scores 60.8 (C) on agent readiness against AI Diagram Maker MCP's 43.8 (E), and leads in every scored category.\n\n### Do AI Diagram Maker MCP and Diagrams.so API + MCP need an API key?\n\nAI Diagram Maker MCP needs an API key. Diagrams.so API + MCP takes an API key or an OAuth sign-in.\n\n### Can an agent call AI Diagram Maker MCP and Diagrams.so API + MCP without installing anything?\n\nYes. AI Diagram Maker MCP has a hosted endpoint at https://mcp.aidiagrammaker.com/mcp and Diagrams.so API + MCP at https://api.diagrams.so/api/v2.\n\n\n## For agents\n\n- This comparison as JSON: https://www.anchorterminal.com/compare/ai-diagram-maker-mcp-vs-diagrams-so.json, and with the fewest tokens: https://www.anchorterminal.com/compare/ai-diagram-maker-mcp-vs-diagrams-so.min.md\n- Over MCP at https://www.anchorterminal.com/mcp (no key): `compare_tools {\"a\": \"ai-diagram-maker-mcp\", \"b\": \"diagrams-so\"}`. From a terminal: `anchor compare ai-diagram-maker-mcp diagrams-so`\n- Each listing in full: https://www.anchorterminal.com/api/v1/tools/ai-diagram-maker-mcp.json and https://www.anchorterminal.com/api/v1/tools/diagrams-so.json\n\n## Other comparisons with AI Diagram Maker MCP or Diagrams.so API + MCP\n\n- [AI Diagram Maker MCP vs Cloudviz API](https://www.anchorterminal.com/compare/ai-diagram-maker-mcp-vs-cloudviz.md)\n- [AI Diagram Maker MCP vs D2](https://www.anchorterminal.com/compare/ai-diagram-maker-mcp-vs-d2.md)\n- [AI Diagram Maker MCP vs draw.io + MCP](https://www.anchorterminal.com/compare/ai-diagram-maker-mcp-vs-drawio.md)\n- [AI Diagram Maker MCP vs Eraser API + MCP](https://www.anchorterminal.com/compare/ai-diagram-maker-mcp-vs-eraser.md)\n- [AI Diagram Maker MCP vs ExcaliClaw](https://www.anchorterminal.com/compare/ai-diagram-maker-mcp-vs-excaliclaw.md)\n- [AI Diagram Maker MCP vs Excalidraw](https://www.anchorterminal.com/compare/ai-diagram-maker-mcp-vs-excalidraw.md)\n- [AI Diagram Maker MCP vs Kroki](https://www.anchorterminal.com/compare/ai-diagram-maker-mcp-vs-kroki.md)\n- [AI Diagram Maker MCP vs Lucid API + MCP](https://www.anchorterminal.com/compare/ai-diagram-maker-mcp-vs-lucid.md)\n- [AI Diagram Maker MCP vs Mermaid Chart MCP](https://www.anchorterminal.com/compare/ai-diagram-maker-mcp-vs-mermaid-chart.md)\n- [AI Diagram Maker MCP vs Mumble](https://www.anchorterminal.com/compare/ai-diagram-maker-mcp-vs-mumble.md)\n- [AI Diagram Maker MCP vs Mural MCP](https://www.anchorterminal.com/compare/ai-diagram-maker-mcp-vs-mural-mcp.md)\n- [AI Diagram Maker MCP vs PlantUML](https://www.anchorterminal.com/compare/ai-diagram-maker-mcp-vs-plantuml.md)\n- [AI Diagram Maker MCP vs Structurizr + MCP](https://www.anchorterminal.com/compare/ai-diagram-maker-mcp-vs-structurizr.md)\n- [AI Diagram Maker MCP vs tldraw SDK + MCP](https://www.anchorterminal.com/compare/ai-diagram-maker-mcp-vs-tldraw.md)\n- [AI Diagram Maker MCP vs Whimsical MCP](https://www.anchorterminal.com/compare/ai-diagram-maker-mcp-vs-whimsical.md)\n- [Cloudviz API vs Diagrams.so API + MCP](https://www.anchorterminal.com/compare/cloudviz-vs-diagrams-so.md)\n- [D2 vs Diagrams.so API + MCP](https://www.anchorterminal.com/compare/d2-vs-diagrams-so.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 ExcaliClaw](https://www.anchorterminal.com/compare/diagrams-so-vs-excaliclaw.md)\n- [Diagrams.so API + MCP vs Excalidraw](https://www.anchorterminal.com/compare/diagrams-so-vs-excalidraw.md)\n- [Diagrams.so API + MCP vs Kroki](https://www.anchorterminal.com/compare/diagrams-so-vs-kroki.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 Mermaid Chart MCP](https://www.anchorterminal.com/compare/diagrams-so-vs-mermaid-chart.md)\n- [Diagrams.so API + MCP vs Mumble](https://www.anchorterminal.com/compare/diagrams-so-vs-mumble.md)\n- [Diagrams.so API + MCP vs Mural MCP](https://www.anchorterminal.com/compare/diagrams-so-vs-mural-mcp.md)\n- [Diagrams.so API + MCP vs PlantUML](https://www.anchorterminal.com/compare/diagrams-so-vs-plantuml.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", "meta": { "attribution": "Anchor Terminal (https://www.anchorterminal.com)", "attributionRequired": true, "credit": "CC BY 4.0, credit Anchor Terminal and link the page or API address you took it from (https://www.anchorterminal.com/terms/#data)", "docs": "https://www.anchorterminal.com/docs/", "generatedAt": "2026-11-07", "license": "CC-BY-4.0", "method": "https://www.anchorterminal.com/benchmark/", "methodology": "0.7", "openapi": "https://www.anchorterminal.com/openapi.json", "preview": false, "run": "2026-10-01", "runLabel": "October 2026 research run", "terms": "https://www.anchorterminal.com/terms/#data" }, "page": { "breadcrumbs": [ { "name": "Home", "url": "https://www.anchorterminal.com/" }, { "name": "Compare", "url": "https://www.anchorterminal.com/compare/" }, { "name": "AI Diagram Maker MCP vs Diagrams.so API + MCP", "url": "" } ], "description": "Diagrams.so scores 60.8 (C) to AI Diagram Maker MCP's 43.8 (E) for diagram creation. Prices, MCP, x402, uptime and agent notes side by side.", "facts": [ "AI Diagram Maker MCP E 43.8", "Diagrams.so API + MCP C 60.8", "scores" ], "h1": "AI Diagram Maker MCP vs Diagrams.so API + MCP", "image": "https://www.anchorterminal.com/assets/og/default.png", "path": "/compare/ai-diagram-maker-mcp-vs-diagrams-so", "published": "2026-10-01", "section": "tools", "title": "AI Diagram Maker MCP vs Diagrams.so for AI agents (2026)", "toc": null, "updated": "2026-11-07", "url": "https://www.anchorterminal.com/compare/ai-diagram-maker-mcp-vs-diagrams-so" }, "tokens": { "markdown": 5100, "slim": 2980 }, "version": 1 }