Visual MCP Tool Map

Once a client is connected to /api/mcp, the workspace gateway exposes a typed tool surface for inspecting canvases, running and inspecting workflow executions, managing assets, and administering the workspace. Which tools an agent can actually call depends on the scopes on its builder_ key — see Dashboard setup for the scope list. The tools below are the current surface, grouped by area.

Canvas inspection & lifecycle

Read-only inspection (read:canvases) plus canvas create/rename/archive lifecycle (write:canvas; deletion needs delete:canvas).

• list_canvases — list the workspace's canvases.
• get_canvas_state — read the full graph state of a canvas.
• get_layer_summary / get_visual_tree_summary — summarize layers and the visual tree.
• get_node_info / read_document_node — inspect a node or read document-node content.
• get_computed_visuals — read computed visual properties.
• list_node_defaults — list default settings available for node types.
• fit_viewport — frame the viewport to content.
• create_canvas / rename_canvas — create and rename canvases.
• archive_canvas / restore_canvas / delete_canvas — archive, restore, or permanently delete a canvas.

Canvas authoring (nodes, edges, frames)

Mutate canvas structure. These require write:canvas.

• add_node / update_node_data / delete_node — add, edit, and remove nodes.
• write_document_node — set document-node content.
• move_node / resize_node / layout_nodes — position, size, and auto-layout nodes.
• add_edge / delete_edge — connect or disconnect node ports.
• create_artboard / create_frame — create container surfaces.
• add_node_to_frame / set_node_parent / move_node_within_frame / move_frame_with_children — manage frame membership and nesting.

Port & connection validation

Helpers for authoring valid graphs (read:canvases).

• get_port_manifest — list a node's input/output ports.
• validate_connection — check whether a proposed edge is legal.
• explain_invalid_connection — explain why a connection is rejected.

Workflow execution

Trigger and inspect runs. Triggering and lifecycle actions require run:workflows; reads also need read:canvases.

• trigger_workflow — start a workflow execution.
• list_executions — list recent executions.
• get_execution_status — poll the status of a run.
• get_execution_timeline — read the step-by-step timeline of a run.
• get_execution_outputs — read the outputs a run produced.
• cancel_execution — cancel an in-flight run.
• replay_execution / redrive_execution — re-run or redrive a previous execution.

Assets

List, upload, place, and manage workspace and execution assets. Reads use read:assets; mutations use write:assets; permanent purge uses delete:assets.

• list_assets / list_workspace_assets / get_workspace_asset — list and inspect assets.
• list_workspace_asset_usages — see where an asset is used.
• reserve_workspace_asset_upload / finalize_workspace_asset_upload / cancel_workspace_asset_upload — the workspace asset upload lifecycle.
• reserve_asset_upload / finalize_asset_upload / cancel_asset_upload — the execution-asset upload lifecycle.
• place_workspace_asset — place an asset onto a canvas.
• rename_workspace_asset / move_workspace_asset / tag_workspace_asset — organize assets.
• trash_workspace_asset / restore_workspace_asset / purge_workspace_asset — soft-delete, restore, or permanently remove an asset.
• register_webhook — register a webhook for asset/upload events.

Templates

Discover and apply workflow templates (read:canvases to read, write:canvas to apply or publish).

• list_templates / get_template_snapshot — browse templates and read a template snapshot.
• use_template — instantiate a template onto a canvas.
• publish_template / delete_template — publish a new template or remove one.

Workspace administration

Manage the workspace, its members, and its API keys. These require manage:integrations.

• get_workspace_info / rename_workspace — read or rename the workspace.
• list_workspace_members / remove_workspace_member — manage members.
• create_workspace_invite / revoke_workspace_invite — manage invites.
• list_api_keys / create_api_key / revoke_api_key — manage workspace API keys.

Billing

Read credit and billing state (read:billing).

• get_credit_balance — read the current credit balance.
• list_credit_transactions — list credit transactions.
• get_billing_summary — read the billing summary.

GitHub integration

Inspect repositories and prepare changes through a connected GitHub installation (manage:integrations).

• github_list_installations / github_list_repositories — discover installations and repositories.
• github_sync_repository — sync a repository.
• github_get_file / github_get_repository_tree / github_search_files — read files and search the tree.
• github_attach_file_to_canvas — attach a repo file to a canvas.
• github_get_pull_request / github_create_branch / github_prepare_pull_request / github_create_draft_pull_request — inspect PRs and prepare branches and draft pull requests.

Google Workspace integration

Move documents between Google Workspace and BuilderStudio (manage:integrations).

• google_import_document — import a Google document.
• google_export_document — export a document to Google Workspace.