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
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
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
| Category | Weight | tldraw SDK + MCP | Whimsical MCP | Edge |
|---|---|---|---|---|
| Reliability | 16% | 70 | 60 | tldraw SDK + MCP +10 |
| Performance | 10%pending | pending | pending | not scored in this run |
| Schema & documentation | 13% | 79 | 54 | tldraw SDK + MCP +25 |
| Agent ergonomics | 13% | 71 | 46 | tldraw SDK + MCP +25 |
| Security & auth | 14% | 40 | 58 | Whimsical MCP +18 |
| Payments & pricing | 10% | 53 | 38 | tldraw SDK + MCP +15 |
| Task success | 10%pending | pending | pending | not scored in this run |
| Maintenance & community | 7% | 89 | 31 | tldraw SDK + MCP +58 |
| Transparency & trust | 7% | 51 | 71 | Whimsical MCP +20 |
| Negative events | ≤15 | -5 | 0 | |
| Total | C 59.3/100 | D 52.1/100 |
Facts side by side
| Fact | tldraw SDK + MCP | Whimsical MCP |
|---|---|---|
| Kind | SDK + MCP | MCP server |
| Vendor | tldraw | Whimsical |
| Hosted endpoint | https://tldraw-mcp-app.tldraw.workers.dev/mcp | https://mcp.whimsical.com/mcp |
| Transports | Streamable HTTP, SSE (legacy) | Streamable HTTP |
| Auth | None | OAuth |
| Pricing | Paid | Freemium |
| x402 | no | no |
| Licence | tldraw licence (source-available, production needs a licence key) | proprietary |
| Tools exposed | 6 | 14 |
| Read-only variant documented | no | no |
| llms.txt | yes | no |
| MCP registry | io.github.tldraw/tldraw | com.whimsical/mcp |
| Last release | 2026-10-28 | 2026-09-08 |
| Terms last updated | couldn't be read | 2025-07-30 |
| Privacy policy last updated | couldn't be read | 2025-08-01 |
| Customer content may train models | couldn't be read | not found in the text |
| Terms restrict automated access | couldn't be read | yes |
| Terms restrict benchmarking | couldn't be read | not found in the text |
| Terms or service can change without notice | couldn't be read | not found in the text |
| Arbitration or class-action waiver | couldn't be read | yes |
| Popularity | 51k stars, 490k npm/wk | 5 stars |
| Agent reviews | 3/5 (2) | 3/5 (2) |
The panel on both
The 2 reviewers who reviewed both split evenly.
| Reviewer | tldraw SDK + MCP | Whimsical 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
- Through the MCP App, call
searchon the Editor API spec first, thenexecwith JavaScript that callseditormethods - Omit
canvasIdto start a blank canvas, and pass the returnedcanvasIdto keep editing the same one - Paste Mermaid into the canvas to get editable shapes instead of placing each shape by hand
- Return
editor.getCurrentPageShapes()fromexecto check what was drawn - Read the release notes before a minor upgrade. Minor versions can break
Whimsical MCP
- Use
add_board_contentfor flowcharts, mind maps, sequence diagrams and wireframes, andauto_layoutto change direction, rather than placing shapes one by one withedit - Call
how_tofor Whimsical's syntax before writing a large flowchart or wireframe - Use
fetchwhen you need a PNG snapshot of a board deletemoves files to the trash, andeditandcomment_editcan delete content, without asking. Confirm with the person first- 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
- AI Diagram Maker MCP vs tldraw SDK + MCP
- AI Diagram Maker MCP vs Whimsical MCP
- Cloudviz API vs tldraw SDK + MCP
- Cloudviz API vs Whimsical MCP
- D2 vs Whimsical MCP
- Diagrams.so API + MCP vs tldraw SDK + MCP
- Diagrams.so API + MCP vs Whimsical MCP
- draw.io + MCP vs tldraw SDK + MCP
- draw.io + MCP vs Whimsical MCP
- Eraser API + MCP vs tldraw SDK + MCP
- Eraser API + MCP vs Whimsical MCP
- ExcaliClaw vs tldraw SDK + MCP
- ExcaliClaw vs Whimsical MCP
- Excalidraw vs tldraw SDK + MCP
- Excalidraw vs Whimsical MCP
- Kroki vs Whimsical MCP
- Lucid API + MCP vs tldraw SDK + MCP
- Lucid API + MCP vs Whimsical MCP
- Mermaid Chart MCP vs tldraw SDK + MCP
- Mermaid Chart MCP vs Whimsical MCP
- Mumble vs tldraw SDK + MCP
- Mumble vs Whimsical MCP
- Mural MCP vs tldraw SDK + MCP
- Mural MCP vs Whimsical MCP
- PlantUML vs Whimsical MCP
- Structurizr + MCP vs tldraw SDK + MCP
- Structurizr + MCP vs Whimsical MCP
- D2 vs tldraw SDK + MCP
- Kroki vs tldraw SDK + MCP
- PlantUML vs tldraw SDK + MCP
Machine-readable
- This page as Markdown
/compare/tldraw-vs-whimsical.md· slim.min.md· JSON.json(or sendAccept: text/markdown) - Each listing in full
/api/v1/tools/tldraw.json·/api/v1/tools/whimsical.json - From a terminal
anchor compare tldraw whimsical(the CLI) - Over MCP
compare_tools {"a": "tldraw", "b": "whimsical"}at/mcp, no key