MCP tool reference
The tools available to a connected agent depend on the permission of its key.
Read tools
| Tool | Purpose |
|---|---|
list_workspaces | Return the workspace accessible to this key. |
list_diagrams | Find diagrams in the authorized workspace. |
list_projects | List the workspace’s project folders. |
get_diagram | Read a diagram and its revision. |
export_mermaid | Export a diagram as Mermaid text. |
Tools that require Suggest edits
| Tool | Purpose |
|---|---|
create_diagram | Create a diagram in the authorized workspace, optionally in a project. |
propose_edit | Submit operations against a diagram revision for review. |
The agent reads the latest diagram revision before proposing edits. Existing-diagram proposals wait for acceptance in the canvas. Creating a diagram is an immediate action permitted by a Suggest edits key.
Workspace scope
A key cannot access a different workspace, even if its owner belongs to several. The server provides each tool’s input schema to your MCP client. Use that schema for exact arguments and supported edit operations.