# tldraw (verified)

Create and edit diagrams, wireframes, and sketches on a shared canvas. Export drawings and collaborate visually in real time.

## Quick Start

```bash
# Connect this server (installs CLI if needed)
npx -y @smithery/cli@latest mcp add tldraw

# Browse available tools
npx -y @smithery/cli@latest tool list tldraw

# Get full schema for a tool
npx -y @smithery/cli@latest tool get tldraw diagram_drawing_read_me

# Call a tool
npx -y @smithery/cli@latest tool call tldraw diagram_drawing_read_me '{}'
```

## Direct MCP Connection

Endpoint: `https://tldraw.run.tools`

## Tools (6)

- `diagram_drawing_read_me` — Use whenever you want to create a diagram or drawing. Gets the tldraw shape format reference. Call this FIRST before cr…
- `create_shapes` — Creates shapes, drawings, and diagrams on the tldraw canvas.
- `update_shapes` — Updates existing shapes, diagrams, and drawings on the tldraw canvas.
- `delete_shapes` — Deletes shapes by id from a JSON string (string[]).
- `read_checkpoint` — App-only: read shapes from a checkpoint by ID.
- `save_checkpoint` — App-only: save shapes to a checkpoint (from user edits). shapesJson and assetsJson must be JSON array strings.

```bash
# Get full input/output schema for a tool
npx -y @smithery/cli@latest tool get tldraw <tool-name>
```

## Resources

- `ui://show-canvas/mcp-app.html` — Interactive tldraw canvas UI used by create, update, and delete shape tools.
