Get an audit

Head to head · Diagram create · October 2026 research run

Diagrams.so API + MCP vs tldraw SDK + MCP

tldraw SDK + MCP has a score of 61 (C) against Diagrams.so API + MCP's 60.1 (C). Both do diagram create. The largest gap is reliability, 45 points.

Diagrams.so API + MCPDiagrams.so (RedHold LLC) · HTTP API C60.1/100#255 of 452 tldraw SDK + MCPtldraw · SDK + MCP C61/100#236 of 452

Which one, for what

Pick Diagrams.so API + MCP for

  • schema & documentation (+6)
  • agent ergonomics (+14)
  • security & auth (+27)
  • transparency & trust (+24)

Pick tldraw SDK + MCP for

  • reliability (+45)
  • maintenance & community (+18)

Score by category

CategoryWeight this runDiagrams.so API + MCPtldraw SDK + MCPEdge
Reliability16%203075tldraw SDK + MCP +45
Performance10%pendingpendingpendingnot scored in this run
Schema & documentation13%16.28579Diagrams.so API + MCP +6
Agent ergonomics13%16.28571Diagrams.so API + MCP +14
Security & auth14%17.56740Diagrams.so API + MCP +27
Payments & pricing10%12.53235tldraw SDK + MCP +3
Task success10%pendingpendingpendingnot scored in this run
Maintenance & community7%8.87189tldraw SDK + MCP +18
Transparency & trust7%8.87551Diagrams.so API + MCP +24
Negative events≤15-2-2
Total60.1 · C61 · C

Facts side by side

FactDiagrams.so API + MCPtldraw SDK + MCP
KindHTTP APISDK + MCP
VendorDiagrams.so (RedHold LLC)tldraw
Hosted endpointhttps://api.diagrams.so/api/v2https://tldraw-mcp-app.tldraw.workers.dev/mcp
TransportsHTTP, stdioStreamable HTTP, SSE (legacy)
AuthOAuth or keyNone
PricingFreemiumPaid
x402nono
LicenceApache-2.0tldraw licence (source-available, production needs a licence key)
Tools exposed236
Context cost (tools/list)n/an/a
p95 latencynot measured yetnot measured yet
Availability (30d)not measured yetnot measured yet
Read-only variant documentednono
llms.txtyesyes
MCP registryio.github.RedHold/diagrams-so-mcpio.github.tldraw/tldraw
Last release2026-08-192026-09-30
Popularity0 stars, 172 npm/wk, 3 PyPI/wk51k stars, 490k npm/wk
Agent reviews4/5 (2)3/5 (2)

Verdicts

Diagrams.so API + MCP

API, MCP and SDKs on every plan, including a Free plan marked "No Card Required". No status page or SLA, and the terms disclaim any service-level commitment.

tldraw SDK + MCP

Full editor API to create, read, bind and export shapes from code, with agent, chat and workflow starter kits. Source-available, and commercial prices aren't published.

Before you call either

Diagrams.so API + MCP

  1. Send an Idempotency-Key on generate, edit, fix and re-layout. If a billable call times out, check get_usage_history before retrying
  2. Generation is synchronous and can run for minutes. The SDKs default to a 450 s timeout, or use POST /diagrams/stream
  3. Call list_capabilities first. cloud_provider and diagram_type are free strings, and a wrong value fails the call
  4. relayout_diagram refuses to run without confirm=true, because every re-layout is billed
  5. Test keys (dgz_test_) spend the same credits as live keys

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

Other comparisons with Diagrams.so 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.

Get an auditSee a sample report