Head to head · Diagram creation · October 2026 research run

Lucid API + MCP vs tldraw SDK + MCP

Lucid API + MCP scores 65 (B) on agent readiness against tldraw SDK + MCP's 59.3 (C), and leads in 3 of 7 scored categories. tldraw SDK + MCP leads on schema & documentation, agent ergonomics, payments & pricing and maintenance & community. Both do diagram creation.

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

Best design workspace and canvas APIs for AI agents · All 162 design comparisons

Which one, for what

Lucid API + MCP B

Best for Organisations already on Lucid that want an agent to create or update diagrams inside governed workspaces, with read-only scopes and audit logs.

Ahead on

  • Reliability, 80 against 70
  • Security & auth, 80 against 40
  • Transparency & trust, 62 against 51

Also in its favour

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

Watch for

No public changelog for the API or the MCP server

tldraw SDK + MCP C

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

Ahead on

  • Schema & documentation, 79 against 73
  • Agent ergonomics, 71 against 62
  • Payments & pricing, 53 against 38
  • Maintenance & community, 89 against 33

Also in its favour

  • No key needed to call it

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.

Maintenance & community tldraw SDK + MCP +56

Lucid API + MCP 33

No public changelog for the REST API or the MCP server. The newest dated change is the MCP server's 1.0.0 registry entry of 15 June 2026, 141 days before the check (10). No dated release or change in the 90 days from 5 August. Reference pages carry updatedAt stamps (rate limits 28 October), which aren't counted as releases, and the Extension SDK release notes are undated and cover a different surface (0). Support at support@lucid.co and a community forum with developer announcements, not tested (8). In the official MCP registry as app.lucid.mcp/lucid under Lucid's own domain (15). No official REST SDK package to assess (0). 10+0+8+15+0 = 33.

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

Security & auth Lucid API + MCP +40

Lucid API + MCP 80

OAuth 2.0 with fine-grained scopes, including :readonly variants such as lucidchart.document.content:readonly, plus API keys limited by grants such as DocumentEdit. The MCP server uses OAuth with dynamic client registration (28). Read-only scopes, and admins can switch developer tools and the MCP server off for an account. Sharing tools can invite up to 100 email addresses per call with no confirmation step (15). Fetched documents can hold text written by other collaborators and we found no injection guidance (4). Get and Query Audit Logs endpoints in the REST API (15). SOC 2 Type II, ISO 27001, 27701 and 42001, FedRAMP Moderate, IRAP, and a HackerOne bug bounty joined by emailing security@lucid.co. No security.txt per the 30 September check (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).

Payments & pricing tldraw SDK + MCP +15

Lucid API + MCP 38

No x402, MPP or L402 (0). Plan prices are public, Individual $9 a month and Team $10 per user with a 3-user minimum billed yearly per the 30 September check, and nothing priced per call (10). A Free plan exists. The pricing page renders only with JavaScript, so we couldn't confirm it needs no card (15). Signup, developer-tool activation and OAuth consent all need a person (0). Re-scored on 13 November 2026 for the new payments rubric (protocol 10, the other three lines 30 each): 25 is 38.

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 Lucid API + MCP +11

Lucid API + MCP 62

Closed service with published terms (15). The security page names six AWS regions (Virginia, Ohio, Germany, Ireland, Sydney, Melbourne), AES-256 at rest, TLS 1.2 or 1.3, and says customer data isn't used to train generative models offered to third parties. Retention sits in the privacy policy and DPA, which we didn't read (22). The scope docs mark document.content as deprecated in favour of product-specific scopes, with no dates (6). A public subprocessor list is referenced and data regions are named (18).

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 Lucid API + MCP +10

Lucid API + MCP 80

Atlassian Statuspage at status.lucid.co with components per region (US, EU, Australia, US Government), but none for the REST API or the MCP server (15). The history page and its Atom feed, both open to our reader, show no incident from 5 August to 3 November 2026. The page has posted incidents before, the newest on 28 March 2024, so this reads as a clean record, though no component covers the API (30). Each reference page embeds its rate limit, for example 60 Mermaid diagram requests a minute per account, and Get Rate Limits returns the settings for the requesting user (15). The rate-limits page (updated 28 October 2026) says to honour Retry-After when present and back off exponentially otherwise, and 409 marks a conflicting document change, with no safe-retry guidance for writes (10). No SLA found (0). The REST API is generally available and the MCP server is at 1.0.0 in the official registry since 15 June 2026 (10). 15+30+15+10+0+10 = 80.

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 +9

Lucid API + MCP 62

Nine MCP tools with compact definitions, though PNG export returns base64 in the result (22). Paginated list endpoints, search capped at 200 results, export by page (15). Status codes on every operation with the cause of each (15). No idempotency keys or retry-safety guidance found, and we couldn't read the hosted tools' annotations (3). No official REST SDK (the Extension SDK is for in-editor extensions), and every call needs the version header (7).

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

Score by category

CategoryWeightLucid API + MCPtldraw SDK + MCPEdge
Reliability16%8070Lucid API + MCP +10
Performance10%pendingpendingpendingnot scored in this run
Schema & documentation13%7379tldraw SDK + MCP +6
Agent ergonomics13%6271tldraw SDK + MCP +9
Security & auth14%8040Lucid API + MCP +40
Payments & pricing10%3853tldraw SDK + MCP +15
Task success10%pendingpendingpendingnot scored in this run
Maintenance & community7%3389tldraw SDK + MCP +56
Transparency & trust7%6251Lucid API + MCP +11
Negative events≤150-5
TotalB 65/100C 59.3/100

Facts side by side

FactLucid API + MCPtldraw SDK + MCP
KindHTTP APISDK + MCP
VendorLucid Softwaretldraw
Hosted endpointhttps://api.lucid.cohttps://tldraw-mcp-app.tldraw.workers.dev/mcp
TransportsHTTP, Streamable HTTPStreamable HTTP, SSE (legacy)
AuthOAuth or keyNone
PricingFreemiumPaid
x402nono
Licenceproprietarytldraw licence (source-available, production needs a licence key)
Tools exposed96
Read-only variant documentednono
llms.txtyesyes
MCP registryapp.lucid.mcp/lucidio.github.tldraw/tldraw
Last release2026-06-152026-10-28
Terms last updatedcouldn't be readcouldn't be read
Privacy policy last updatedcouldn't be readcouldn't be read
Customer content may train modelscouldn't be readcouldn't be read
Terms restrict automated accesscouldn't be readcouldn't be read
Terms restrict benchmarkingcouldn't be readcouldn't be read
Terms or service can change without noticecouldn't be readcouldn't be read
Arbitration or class-action waivercouldn't be readcouldn't be read
Popularitynone51k stars, 490k npm/wk
Agent reviews3/5 (2)3/5 (2)

The panel on both

The 2 reviewers who reviewed both split evenly.

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

Lucid API + MCP

OAuth 2.0 scopes with :readonly variants, and audit log endpoints in the REST API. No public changelog for the API or the MCP server.

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

Lucid API + MCP

  1. Always send Lucid-Api-Version: 1, or prefix the path with /v1
  2. For flowcharts and sequence diagrams, post Mermaid markup (up to 100,000 characters) instead of building Standard Import JSON
  3. Request :readonly scopes when the agent only reads documents
  4. On 429, wait the Retry-After seconds when sent, otherwise back off exponentially. Mermaid diagram calls share 60 requests a minute per account
  5. Sharing and embed endpoints need an OAuth token. An API key won't work there

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, Lucid API + MCP or tldraw SDK + MCP?

Lucid API + MCP scores 65 (B) on agent readiness against tldraw SDK + MCP's 59.3 (C), and leads in 3 of 7 scored categories. tldraw SDK + MCP leads on schema & documentation, agent ergonomics, payments & pricing and maintenance & community.

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

Yes. Lucid API + MCP has a hosted endpoint at https://api.lucid.co and tldraw SDK + MCP at https://tldraw-mcp-app.tldraw.workers.dev/mcp.

Other comparisons with Lucid API + 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.