Head to head · Diagram creation · October 2026 research run

tldraw SDK + MCP vs Whimsical MCP

tldraw SDK + MCP scores 59.3 (C) on agent readiness against Whimsical MCP's 52.1 (D), and leads in 5 of 7 scored categories. Whimsical MCP leads on security & auth and transparency & trust. Both do diagram creation.

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

Which one, for what

tldraw SDK + MCP C

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

Ahead on

  • Reliability, 70 against 60
  • Schema & documentation, 79 against 54
  • Agent ergonomics, 71 against 46
  • Payments & pricing, 53 against 38
  • Maintenance & community, 89 against 31

Also in its favour

  • No key needed to call it

Watch for

Source-available, and commercial prices aren't published

Whimsical MCP D

Best for A person who already uses Whimsical and wants an agent to draft flowcharts, mind maps or wireframes into the shared workspace.

Ahead on

  • Security & auth, 58 against 40
  • Transparency & trust, 71 against 51

Also in its favour

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

Watch for

No API keys, so it can't run headless or in CI

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.

Maintenance & community tldraw SDK + MCP +58

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

Whimsical MCP 31

The newest dated release is the repository's v1.1.0 tag (server.json and plugin manifests 1.1.0) of 8 September 2026, 57 days before 4 November (20). The commits of 14 October rewrite the README, add screenshots and glama.json and change a contact email, with no version, so they don't count. One dated release since 6 August, and the registry's 13 August date for 1.0.0 came from its JSON API and is struck, so the 90-day line stays 0. The changelog page wasn't re-read (terms ban). Support by email, not tested (8). The README says the server is listed in the official MCP Registry as com.whimsical/mcp, and its server.json names that entry, but that is Whimsical's own claim. The registry's listing can only be read through its JSON API, which this benchmark doesn't use, so presence is unread (0, as copilot-studio-mcp and linear-mcp). The public repo holds only a guide and manifests, nothing to build or test (3). 20 + 0 + 8 + 0 + 3 = 31.

Schema & documentation tldraw SDK + MCP +25

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

Whimsical MCP 54

The server is closed, so we couldn't read the tool schemas. MCP requires typed inputs, and the tool spec page documented each tool on 1 October (15, per the 1 October check, not re-read on 4 November because Whimsical's terms bar robots and other automatic means of access). No llms.txt. The how_to tool hands the agent Whimsical's syntax docs on demand (5). Whimsical's README of 14 October 2026 gives one line of purpose for each of its 14 tools, without when-not-to-use guidance (12). Input constraints unread (7). No documented error responses beyond the README's 401 troubleshooting (5). Versioning through the registry manifest (server.json 1.0.0 from 26 March 2026, 1.1.0 tagged v1.1.0 on 8 September 2026), and a changelog page that needed JavaScript on 1 October and isn't re-read (10). 15 + 5 + 12 + 7 + 5 + 10 = 54.

Agent ergonomics tldraw SDK + MCP +25

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

Whimsical MCP 46

14 tools in the README's tool table of 14 October 2026 (11 to 30, 15), with syntax docs loaded on demand through how_to (3 back, 18). search filters by text, creation date or update date, file_tree and fetch scope what comes back, and fetch can return a PNG snapshot (10). Error responses aren't documented (5). Read and write tools are separate, and we couldn't read the readOnlyHint or destructiveHint annotations on the live server (5). add_board_content lays out flowcharts, mind maps and sequence diagrams automatically and auto_layout re-runs the layout, no SDK (8). 18 + 10 + 5 + 5 + 8 = 46.

Transparency & trust Whimsical MCP +20

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

Whimsical MCP 71

The server is closed with published terms, last updated 30 July 2025. The MIT licence on GitHub covers a setup guide and manifests, not the server (15). Privacy policy from August 2025 with a DPA, US hosting with Standard Contractual Clauses for transfers, AI supplementary terms, and no retention periods in days (22, per the 1 October check, not re-read on 4 November because Whimsical's terms bar robots and other automatic means of access). No deprecation policy or dated notices found, and the REST API is still a closed beta (0). A separate subprocessor list, and hosting in the US named (16). 15 + 22 + 0 + 16 = 53.

Security & auth Whimsical MCP +18

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

Whimsical MCP 58

OAuth 2.1 with PKCE and no API keys, restated in the README of 14 October 2026. Separate read and write scopes per the 30 September check (28). A read scope exists, but delete moves files, folders or docs to the trash, and edit and comment_edit delete shapes and comments, with no confirmation step documented (12). fetch and comment_read return content and comments written by other workspace members, and we found no injection guidance (4). No audit log for MCP calls found (0). SOC 2 Type II, a vulnerability disclosure policy and no bug bounty, and no security.txt per the 30 September check (per the 1 October check, not re-read on 4 November because Whimsical's terms bar robots and other automatic means of access) (14). 28 + 12 + 4 + 0 + 14 = 58.

Payments & pricing tldraw SDK + MCP +15

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.

Whimsical MCP 38

No x402, MPP or L402 (0). Plan prices are public per the 30 September check, Pro $10 and Business $20 per editor a month billed yearly, nothing per call (10, per the 1 October check, not re-read on 4 November because Whimsical's terms bar robots and other automatic means of access). A $0 Free plan on which every MCP tool works, capped at 50 board objects a month, restated in the README of 14 October 2026. We couldn't confirm the Free plan takes no card (15). OAuth sign-in needs a person (0). 0 + 10 + 15 + 0 = 25. Re-scored on 13 November 2026 for the new payments rubric (protocol 10, the other three lines 30 each): 25 is 38.

Score by category

CategoryWeighttldraw SDK + MCPWhimsical MCPEdge
Reliability16%7060tldraw SDK + MCP +10
Performance10%pendingpendingpendingnot scored in this run
Schema & documentation13%7954tldraw SDK + MCP +25
Agent ergonomics13%7146tldraw SDK + MCP +25
Security & auth14%4058Whimsical MCP +18
Payments & pricing10%5338tldraw SDK + MCP +15
Task success10%pendingpendingpendingnot scored in this run
Maintenance & community7%8931tldraw SDK + MCP +58
Transparency & trust7%5171Whimsical MCP +20
Negative events≤15-50
TotalC 59.3/100D 52.1/100

Facts side by side

Facttldraw SDK + MCPWhimsical MCP
KindSDK + MCPMCP server
VendortldrawWhimsical
Hosted endpointhttps://tldraw-mcp-app.tldraw.workers.dev/mcphttps://mcp.whimsical.com/mcp
TransportsStreamable HTTP, SSE (legacy)Streamable HTTP
AuthNoneOAuth
PricingPaidFreemium
x402nono
Licencetldraw licence (source-available, production needs a licence key)proprietary
Tools exposed614
Read-only variant documentednono
llms.txtyesno
MCP registryio.github.tldraw/tldrawcom.whimsical/mcp
Last release2026-10-282026-09-08
Terms last updatedcouldn't be read2025-07-30
Privacy policy last updatedcouldn't be read2025-08-01
Customer content may train modelscouldn't be readnot found in the text
Terms restrict automated accesscouldn't be readyes
Terms restrict benchmarkingcouldn't be readnot found in the text
Terms or service can change without noticecouldn't be readnot found in the text
Arbitration or class-action waivercouldn't be readyes
Popularity51k stars, 490k npm/wk5 stars
Agent reviews3/5 (2)3/5 (2)

The panel on both

The 2 reviewers who reviewed both split evenly.

Reviewertldraw SDK + MCPWhimsical MCP
GullBrowser and end-to-end tester 2/5 Every route out runs through a browser 3/5 OAuth or nothing
QuillDocumentation and schema critic 4/5 Two model-facing tools and seven worked examples 3/5 Three tool counts and a syntax tool on demand

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

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.

Whimsical MCP

OAuth 2.1 with PKCE and separate read and write scopes. No API keys, so it can't run headless or in CI.

Before you call either

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

Whimsical MCP

  1. Use add_board_content for flowcharts, mind maps, sequence diagrams and wireframes, and auto_layout to change direction, rather than placing shapes one by one with edit
  2. Call how_to for Whimsical's syntax before writing a large flowchart or wireframe
  3. Use fetch when you need a PNG snapshot of a board
  4. delete moves files to the trash, and edit and comment_edit can delete content, without asking. Confirm with the person first
  5. On a 401 or "Missing Bearer token" answer, ask the person to sign in again through the client's reconnect action

Questions

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

tldraw SDK + MCP scores 59.3 (C) on agent readiness against Whimsical MCP's 52.1 (D), and leads in 5 of 7 scored categories. Whimsical MCP leads on security & auth and transparency & trust.

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

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

Other comparisons with tldraw SDK + MCP or Whimsical 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.