Cloudviz API vs tldraw SDK + MCP

Cloudviz API

Diagrams come from the live AWS account through a read-only cross-account role with a per-customer external ID. AWS only, and API access starts at the $49 a month Team plan.

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.

Cloudviz API

1. Call GET /aws/accounts/ first to get the Cloudviz account ID, then request /aws/accounts/{account-id}/{region}/{format}
2. On a 202, wait and repeat the same GET until the diagram is ready
3. Ask for jsonSnapshot or jsonDiagram (there is no plain json format) when the agent has to reason over resources
4. Use a read-only key unless the agent has to add, change or delete AWS accounts

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