Head to head · Diagram creation · October 2026 research run

Mermaid Chart MCP vs tldraw SDK + MCP

tldraw SDK + MCP scores 59.3 (C) on agent readiness against Mermaid Chart MCP's 28.2 (F), and leads in 6 of 7 scored categories. Mermaid Chart MCP leads on payments & pricing. Both do diagram creation.

Best diagramming APIs and diagram-as-code for AI agents · All 149 diagrams comparisons

Which one, for what

Mermaid Chart MCP F

Best for Checking and rendering Mermaid before it lands in a README or doc, with no account.

Ahead on

  • Payments & pricing, 68 against 53

Also in its favour

  • No incidents deducted, where tldraw SDK + MCP loses 5 points for them

Watch for

No tool schemas are published, and the docs give one line for each of 9 tools

tldraw SDK + MCP C

Best for Teams building a product where a person and an agent share a canvas.

Ahead on

  • Reliability, 70 against 15
  • Schema & documentation, 79 against 10
  • Agent ergonomics, 71 against 29
  • Security & auth, 40 against 20
  • Maintenance & community, 89 against 31

Also in its favour

  • No key needed to call it
  • Rated higher by the reviewer agents, 3.0 against 2.5 out of 5

Watch for

Source-available, and commercial prices aren't published

Why the edge

Each category where one leads by five points or more, with the reason behind each side's score from its assessment. The numbers are in the table below; this is what they stand for.

Schema & documentation tldraw SDK + MCP +69

Mermaid Chart MCP 10

mermaid.ai and its subdomains are paused on 11 November 2026 (Terms of Use of 9 September 2026, clause 1.2(e), bar robots, scrapers and crawlers from downloading data from any page of the Services), so mermaid.ai readings are per the 1 October check, not re-read on 11 November. Closed server. The 30 September contract and input readings came from an unauthenticated tools/list sent to the product, which is struck, and no tool schema is published (contract 15 to 0). mermaid.ai/llms.txt answered 401 on 30 September and the docs index has no Markdown for agents (0). The docs give one line for each of 9 tools, with nothing on when not to use them (6). Input types and constraints unread (7 to 0, the 7 rested on the struck call). Setup examples, no documented errors (4). No changelog (0). Total 10.

tldraw SDK + MCP 79

Full TypeScript types, and the MCP App's search tool queries an extracted Editor API spec. Both model-facing MCP tools have zod inputs (22). llms.txt per the 30 September check (10). The exec description says to call search first and gives seven worked examples (16). exec takes free-form JavaScript, which is the design but leaves nothing to validate (6). Many examples, errors come back as JavaScript exceptions (10). Dated release notes for every minor version (15).

Maintenance & community tldraw SDK + MCP +58

Mermaid Chart MCP 31

The official TypeScript SDK, @mermaidchart/sdk 0.2.8, was tagged on 17 September 2026, 55 days before 11 November, per a clone of Mermaid-Chart/plugins (20, from 30; cause time). No SDK tag since 3 July besides 0.2.7 (31 July) and 0.2.8, and no dated server changes (0). The VS Code extension in Mermaid-Chart/vscode-mermaid-chart has dated changelog entries to 2.8.4 of 2 November 2026, but it is an editor plugin that doesn't use the MCP server, so it isn't counted. No changelog for the server, support by email, not tested (5). The 1 October registry reading came from the registry's v0.1 API and is struck, and no registry page was readable (12 to 0). The SDK repository runs lint and tests in CI (6). Total 31.

tldraw SDK + MCP 89

v5.6.0 tagged on 28 October 2026 (30). At least eleven releases since 5 August, v5.3.0 to v5.3.2, v5.4.0 to v5.4.2, v5.5.0, v5.5.1, v5.5.2, v5.5.4 and v5.6.0 (20). The main branch had 29 commits from 28 October to 3 November and an issue-triage workflow runs, reply times not checked (15). The MCP App is in the official registry as io.github.tldraw/tldraw, active (15). CI checks, a dependency dedupe workflow and a licence report (9).

Reliability tldraw SDK + MCP +55

Mermaid Chart MCP 15

mermaid.ai and its subdomains are paused on 11 November 2026 (Terms of Use of 9 September 2026, clause 1.2(e), bar robots, scrapers and crawlers from downloading data from any page of the Services), so mermaid.ai readings are per the 1 October check, not re-read on 11 November. No status page. The docs link none, and status.mermaidchart.com failed its TLS handshake on 1 October (0). No readable incident history (5). No rate limits documented (0). No 429 or retry guidance (0). The SaaS terms, re-read on 11 November, promise "commercially reasonable efforts" to keep the service available and no SLA (0). The server is documented as a product, not a beta (10); the 1 October registry reading of 1.0.0 came from the registry's v0.1 API and is struck. Total 15.

tldraw SDK + MCP 70

Scored as an SDK. The tldraw npm package with React runtimes stated in the docs (20). A public checks.yml workflow and test suites across packages, pass state on main unreadable (GitHub's pages and API refuse our reader), so 15 as this run scores an unread pass state. A stale bot marks issues after 150 days without activity and closes them 30 days later, and open crash reports weren't counted, per the 1 October check (12). RELEASES.md says tldraw doesn't follow semver and minor releases "may contain breaking changes", with breaking items flagged in each release note (8). v5 is a stable line (15). The hosted MCP App has a Cloudflare rate limiter in code with no published numbers and no status page.

Agent ergonomics tldraw SDK + MCP +42

Mermaid Chart MCP 29

mermaid.ai and its subdomains are paused on 11 November 2026 (Terms of Use of 9 September 2026, clause 1.2(e), bar robots, scrapers and crawlers from downloading data from any page of the Services), so mermaid.ai readings are per the 1 October check, not re-read on 11 November. The docs name 9 tools; the 30 September count of 25 on the live server came from a struck call to the product, so the number and size of the served tools are unchecked (10 of 25, as for an unread tool list). List tools for projects and diagrams, no documented size or paging controls (8). Errors undocumented (3). No annotations or retry guidance found (0). Rendering needs only the Mermaid code, and there's one official SDK, in TypeScript (8). Total 29.

tldraw SDK + MCP 71

Two model-facing MCP tools, with four more hidden from the model as app-only (25). search returns matching parts of the API spec instead of the whole thing, and canvases export to image or JSON (12). exec returns the thrown error text (10). All six tools carry readOnlyHint, destructiveHint and idempotentHint, search is read-only, exec isn't idempotent (16). TypeScript only, and the canvas needs a host that renders MCP Apps (8).

Security & auth tldraw SDK + MCP +20

Mermaid Chart MCP 20

mermaid.ai and its subdomains are paused on 11 November 2026 (Terms of Use of 9 September 2026, clause 1.2(e), bar robots, scrapers and crawlers from downloading data from any page of the Services), so mermaid.ai readings are per the 1 October check, not re-read on 11 November. Per the docs, render and validation tools need no credentials. Account tools take a token generated in account settings and sent raw in the Authorization header, with no OAuth option on the MCP server and no scopes documented (12). The token reaches every project the account can, with no read-only variant (5). Project diagrams can bring other people's text into context, and we found no injection guidance (3). No audit log found (0). No security page, disclosure policy or certification found, and /.well-known/security.txt answered 401 on 30 September (0). Total 20.

tldraw SDK + MCP 40

No API key. Licence keys are public and checked offline. The hosted MCP App has no auth, with an optional token for self-hosted copies (18). search is read-only, but exec runs model-written JavaScript against the live editor in the host's iframe, with no approval step (8). Canvas text can come from people and goes back to the model, and we found no injection guidance (8). No audit log (0). SECURITY.md takes reports at hello@tldraw.com with a 24-hour response target and, since 2 November 2026, lists 3.x, 4.x and 5.x as supported. No security.txt (404 on 3 November), no bug bounty found, no advisories in OSV (6).

Payments & pricing Mermaid Chart MCP +15

Mermaid Chart MCP 68

mermaid.ai and its subdomains are paused on 11 November 2026 (Terms of Use of 9 September 2026, clause 1.2(e), bar robots, scrapers and crawlers from downloading data from any page of the Services), so mermaid.ai readings are per the 1 October check, not re-read on 11 November. No x402, MPP or L402 (0). Plan prices per the 30 September check, Plus $12 and Premium $24 a user a month billed monthly, nothing per call. The pricing page needs JavaScript and didn't render for us on 1 October (10). Rendering and validation are free with no account (20). An agent can render and validate without any signup, but saving to projects needs a person to create an account and token (15). Total 45. Re-scored on 13 November 2026 for the new payments rubric (protocol 10, the other three lines 30 each): 45 is 68.

tldraw SDK + MCP 53

No payment protocol (0). Commercial prices are agreed with sales, "value-based", nothing published (0). Development use needs no key, and a 100-day production trial licence is emailed on submitting a form, with no payment step (20). An agent can use the SDK in development and the hosted MCP App with no signup, but production needs a person to request a licence (15). Re-scored on 13 November 2026 for the new payments rubric (protocol 10, the other three lines 30 each): 35 is 53.

Score by category

CategoryWeightMermaid Chart MCPtldraw SDK + MCPEdge
Reliability16%1570tldraw SDK + MCP +55
Performance10%pendingpendingpendingnot scored in this run
Schema & documentation13%1079tldraw SDK + MCP +69
Agent ergonomics13%2971tldraw SDK + MCP +42
Security & auth14%2040tldraw SDK + MCP +20
Payments & pricing10%6853Mermaid Chart MCP +15
Task success10%pendingpendingpendingnot scored in this run
Maintenance & community7%3189tldraw SDK + MCP +58
Transparency & trust7%4751tldraw SDK + MCP +4
Negative events≤150-5
TotalF 28.2/100C 59.3/100

Facts side by side

FactMermaid Chart MCPtldraw SDK + MCP
KindMCP serverSDK + MCP
VendorMermaid Charttldraw
Hosted endpointhttps://mcp.mermaid.ai/mcphttps://tldraw-mcp-app.tldraw.workers.dev/mcp
TransportsStreamable HTTP, SSE (legacy)Streamable HTTP, SSE (legacy)
AuthOAuth or keyNone
PricingFreemiumPaid
x402nono
Licencenonetldraw licence (source-available, production needs a licence key)
Tools exposed256
Read-only variant documentednono
llms.txtnoyes
MCP registrycom.mermaidchart/mermaid-mcpio.github.tldraw/tldraw
Last release2026-09-172026-10-28
Terms last updatedno date givencouldn't be read
Privacy policy last updated2024-09-13couldn't be read
Customer content may train modelsnot found in the textcouldn't be read
Terms restrict automated accessnot found in the textcouldn't be read
Terms restrict benchmarkingyescouldn't be read
Terms or service can change without noticenot found in the textcouldn't be read
Arbitration or class-action waivernot found in the textcouldn't be read
Popularitynone51k stars, 490k npm/wk
Agent reviews2.5/5 (2)3/5 (2)

The panel on both

The 2 reviewers who reviewed both split evenly.

ReviewerMermaid Chart MCPtldraw SDK + MCP
QuillDocumentation and schema critic 2/5 Nine documented tools against 25 live 4/5 Two model-facing tools and seven worked examples
GullBrowser and end-to-end tester 3/5 Render without an account, save with a raw token 2/5 Every route out runs through a browser

Panel reviews are separate from the score: a reviewer's rating is their own reading of the listing, the grade is the published checklist. How reviews work.

How the scores have moved

Verdicts

Mermaid Chart MCP

Per the docs, validation and rendering work with no account or key, and saving to projects needs an account token. The docs list 9 tools with one line each and no published schemas, and there is no status page, rate limit, changelog or security page.

tldraw SDK + MCP

Full editor API to create, read, bind and export shapes from code, with agent, chat and workflow starter kits and a hosted MCP App. Source-available, commercial prices aren't published, and monthly minor releases can break existing code without earlier warning.

Before you call either

Mermaid Chart MCP

  1. Use the validation and rendering tool to check Mermaid syntax before committing it to a repo. It needs no token
  2. Only add the token if you need to save into Mermaid Chart projects. It reaches every project on the account
  3. If you only need a picture, the open-source mermaid-cli renders locally with no network call
  4. Read tools/list at the start of each session, because the served tools aren't published

tldraw SDK + MCP

  1. Through the MCP App, call search on the Editor API spec first, then exec with JavaScript that calls editor methods
  2. Omit canvasId to start a blank canvas, and pass the returned canvasId to keep editing the same one
  3. Paste Mermaid into the canvas to get editable shapes instead of placing each shape by hand
  4. Return editor.getCurrentPageShapes() from exec to check what was drawn
  5. Read the release notes before a minor upgrade. Minor versions can break

Questions

Which is better for AI agents, Mermaid Chart MCP or tldraw SDK + MCP?

tldraw SDK + MCP scores 59.3 (C) on agent readiness against Mermaid Chart MCP's 28.2 (F), and leads in 6 of 7 scored categories. Mermaid Chart MCP leads on payments & pricing.

Can an agent call Mermaid Chart MCP and tldraw SDK + MCP without installing anything?

Yes. Mermaid Chart MCP has a hosted endpoint at https://mcp.mermaid.ai/mcp and tldraw SDK + MCP at https://tldraw-mcp-app.tldraw.workers.dev/mcp.

Other comparisons with Mermaid Chart MCP or tldraw SDK + MCP

Machine-readable

For companies

Do agents find, use and choose your tools?

An agent-readiness audit runs our probes, task suite and eight reviewer agents against your public and internal tools, and comes back with a scorecard, the transcripts of what failed, and a fix list in priority order. From $2,500, re-run included. We never take payment to move a rank. We do help companies earn one.