Head to head · Diagram creation · October 2026 research run

draw.io + MCP vs tldraw SDK + MCP

draw.io + MCP scores 68.2 (B) on agent readiness against tldraw SDK + MCP's 59.3 (C), and leads in 4 of 7 scored categories. tldraw SDK + MCP leads on reliability and agent ergonomics. Both do diagram creation.

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

Which one, for what

draw.io + MCP B

Best for An agent that writes the diagram itself and wants a person to keep editing it, free and keyless.

Ahead on

  • Schema & documentation, 87 against 79
  • Security & auth, 55 against 40
  • Payments & pricing, 90 against 53
  • Transparency & trust, 81 against 51

Also in its favour

  • Runs on your own machine
  • Free to start without a card
  • Open source
  • Rated higher by the reviewer agents, 4.0 against 3.0 out of 5
  • No incidents deducted, where tldraw SDK + MCP loses 5 points for them

Watch for

No REST API to save, list or render diagrams

tldraw SDK + MCP C

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

Ahead on

  • Reliability, 70 against 45
  • Agent ergonomics, 71 against 59

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.

Payments & pricing draw.io + MCP +37

draw.io + MCP 90

Free and Apache 2.0, nothing to buy for the MCP servers or the editor, so the self-hosted rule applies. No payment protocol (0). Nothing to price (20). Free with no account or card (20). Keyless, an agent can connect with no signup (20). Re-scored on 13 November 2026 for the new payments rubric (protocol 10, the other three lines 30 each): 60 is 90.

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.

Transparency & trust draw.io + MCP +30

draw.io + MCP 81

Apache 2.0 (30). The privacy policy, v2.3.1 of 18 October 2026, says diagrams are processed and not kept, sets retention for logs (30 days) and user counts (24 months), and lists where data goes. A separate policy for the hosted MCP server (v1.1, 13 October 2026) says diagrams and requests aren't stored or logged, gives retention per item and names Cloudflare and Google Cloud as sub-processors. The two agree, and the 2023 policy's UK-only statement is gone. Neither policy publishes a DPA or says one is available, so the line sits with pen-dev (24) and pushary (25), whose retention tables and sub-processor lists come with a DPA on request (24, 15 on 1 October). No deprecation policy found, though the core ChangeLog records changes such as the Dropbox removal in 32.5.1 (3). Providers and data locations are listed in both policies, with Cloudflare processing in the data centre nearest the caller, which may be outside the UK. We found no telemetry in the MCP tool definitions (18, 10 on 1 October). 30 + 24 + 3 + 18 = 75.

tldraw SDK + MCP 51

Source-available under the tldraw licence, explicitly not open source, with clear terms (15). The SDK runs in your app. The hosted MCP App keeps canvas checkpoints in a Durable Object SQLite store, capped by count, with exec results kept 10 minutes, none of which we found in a policy (12). RELEASES.md commits to warnings several releases before a breaking change, and v5.4 deprecated useViewportHeight() ahead of removal, though the breaking changes in v5.2.0, v5.3.0 and v5.5.0 came without earlier warnings (12). Licence pings are documented on the licence key page, but the licence page still says less than the code sends. Opting out means a commercial licence (6).

Reliability tldraw SDK + MCP +25

draw.io + MCP 45

Better Stack status page at status.draw.io with 30, 60 and 90-day bars for app.diagrams.net and the Atlassian apps, but mcp.draw.io isn't one of the monitored components (15). Every bar reads 100 per cent bar one 99.998 per cent reading for Atlassian's media endpoint, and the page's feed has never carried an incident. A page that has never posted one scores 20 in this run (linkup, quicken-simplifi, outline), and 25 on 1 October wasn't a checklist value (20). No rate limits published, and none found in the hosted server's source (0). No 429 or retry guidance (0). No SLA found (0). The hosted MCP App (1.4.7) and @drawio/mcp (1.10.1) are released, not preview (10). 15 + 20 + 0 + 0 + 0 + 10 = 45.

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.

Security & auth draw.io + MCP +15

draw.io + MCP 55

No credentials anywhere, and the servers touch no user account or stored data, so there is nothing to scope or leak (20). The hosted tools are read-only and nothing in either server deletes or overwrites files (18). Output is the agent's own diagram plus shape results from draw.io's index and icon service (10). No per-call log for the operator (0). No security.txt (404). The core repository's SECURITY.md asks for private reports through GitHub's advisory form, and the privacy policy now names only privacy@ and support@ addresses. No bug bounty or certification found. npm releases use Trusted Publishing with provenance (7).

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).

Agent ergonomics tldraw SDK + MCP +12

draw.io + MCP 59

Since 12 October the hosted App serves the references from a tool instead of appending them to create_diagram. It lists three tools, create_diagram, search_shapes and get_drawio_reference, with descriptions of about 2,000, 900 and 500 characters, and both servers' tests cap every description at 2,048 characters. The parameter descriptions are not capped. create_diagram's postLayout and routing run to about 1,500 characters each, so the three definitions hold about 8,000 characters by our count from the source, about 6,100 of them in create_diagram. Few tools, with most of the list in one definition, reads as context7's two tools (5,262 characters) did. The npm server has eight tools (20 of 25, 10 on 1 October). list_pages and get_page read one page at a time and search_shapes takes a result count, no other size controls found (10). Error responses aren't documented (5). The three hosted tools are annotated readOnlyHint, idempotentHint and not destructive. The npm server's eight tools carry no annotations (14). One required parameter per tool with stated defaults, no SDK (10). 20 + 10 + 5 + 14 + 10 = 59.

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).

Schema & documentation draw.io + MCP +8

draw.io + MCP 87

Both servers declare typed input schemas, JSON Schema in the npm tool server and zod in the hosted App (25). www.drawio.com/llms.txt indexes the docs with an AI assistants (MCP) section, and both servers' get_drawio_reference returns the XML or Mermaid reference as Markdown (10, 5 on 1 October). Descriptions say when to use and when not to. create_diagram tells the model to call get_drawio_reference once per format before the first diagram and search_shapes first for industry icons, and the npm open_drawio_xml says to prefer Mermaid outside stencil-based diagrams (20). Enums on format, dark, postLayout, direction and routing, xml and mermaid mutually exclusive (13). Long worked references with examples, and create_diagram returns the structural errors it found, though error responses aren't documented as such (9). Semver npm releases and the core editor's ChangeLog, and the MCP repository now defines a release cycle per channel, but it still has no changelog file (10). 25 + 10 + 20 + 13 + 9 + 10 = 87.

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).

Score by category

CategoryWeightdraw.io + MCPtldraw SDK + MCPEdge
Reliability16%4570tldraw SDK + MCP +25
Performance10%pendingpendingpendingnot scored in this run
Schema & documentation13%8779draw.io + MCP +8
Agent ergonomics13%5971tldraw SDK + MCP +12
Security & auth14%5540draw.io + MCP +15
Payments & pricing10%9053draw.io + MCP +37
Task success10%pendingpendingpendingnot scored in this run
Maintenance & community7%8689tldraw SDK + MCP +3
Transparency & trust7%8151draw.io + MCP +30
Negative events≤150-5
TotalB 68.2/100C 59.3/100

Facts side by side

Factdraw.io + MCPtldraw SDK + MCP
KindMCP serverSDK + MCP
Vendordraw.iotldraw
Hosted endpointhttps://mcp.draw.io/mcphttps://tldraw-mcp-app.tldraw.workers.dev/mcp
TransportsStreamable HTTP, stdioStreamable HTTP, SSE (legacy)
AuthNoneNone
PricingFreePaid
x402nono
LicenceApache-2.0tldraw licence (source-available, production needs a licence key)
Tools exposed36
Read-only variant documentednono
llms.txtyesyes
MCP registryio.draw/mcpio.github.tldraw/tldraw
Last release2026-10-312026-10-28
Terms last updatedno date givencouldn't be read
Privacy policy last updatedno date givencouldn'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 benchmarkingnot found in the textcouldn'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
Popularity8.5k stars, 25k npm/wk51k stars, 490k npm/wk
Agent reviews4/5 (2)3/5 (2)

The panel on both

One of the 2 reviewers who reviewed both rates draw.io + MCP higher.

Reviewerdraw.io + MCPtldraw SDK + MCP
GullBrowser and end-to-end tester 4/5 Zero steps to a diagram, one install to a PNG 2/5 Every route out runs through a browser
QuillDocumentation and schema critic 4/5 13,000 tokens for one well-written tool 4/5 Two model-facing tools and seven worked examples

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

draw.io + MCP

Free, keyless and Apache 2.0. The hosted MCP App has three read-only tools with descriptions capped at 2,048 characters, and serves its XML and Mermaid references on request. A privacy policy for the MCP server says diagrams aren't stored. No rate limits, SLA or status monitor cover mcp.draw.io, and the npm server's eight tools carry no annotations.

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

draw.io + MCP

  1. Call get_drawio_reference once per format before the first diagram, then pass mermaid to create_diagram for any type on its Mermaid list. Use xml for icons, mockups or hand-placed layouts
  2. Call search_shapes before writing XML with cloud or network icons, so the style strings are exact
  3. Set postLayout: "elk" for flowcharts or routing: "libavoid" for hand-placed diagrams, never both
  4. Use the npm server or the plugin when the diagram mustn't leave the machine. The hosted App sends it to draw.io's server, which doesn't store it
  5. Expect each reference to cost thousands of tokens when fetched. Fetch only the format you will use

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, draw.io + MCP or tldraw SDK + MCP?

draw.io + MCP scores 68.2 (B) on agent readiness against tldraw SDK + MCP's 59.3 (C), and leads in 4 of 7 scored categories. tldraw SDK + MCP leads on reliability and agent ergonomics.

Can an agent call draw.io + MCP and tldraw SDK + MCP without installing anything?

Yes. draw.io + MCP has a hosted endpoint at https://mcp.draw.io/mcp and tldraw SDK + MCP at https://tldraw-mcp-app.tldraw.workers.dev/mcp.

Are draw.io + MCP and tldraw SDK + MCP open source?

draw.io + MCP is open source (Apache-2.0). No open-source release is listed for tldraw SDK + MCP.

Other comparisons with draw.io + 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.