Hosted tools reference

The hosted MCP server at /mcp exposes 29 tools.

The read-only and paid columns are machine-declared by the application, not written by hand. CLI version 0.2.0, API version v1. A read-only tool does not mutate canvas state, generate media, or spend credit — that is a property of the tool, not a separate endpoint.

All hosted tools

Tool	Toolset	Read-only	Can incur provider cost
`guide_search`	canvas	Yes	No
`guide_get`	canvas	Yes	No
`canvas_list`	canvas	Yes	No
`canvas_get`	canvas	Yes	No
`canvas_validate`	canvas	Yes	No
`canvas_apply_batch`	canvas	No	No
`get_canvas_image`	assets	Yes	No
`open_canvas`	canvas	Yes	No
`save_image_to_canvas`	assets	No	No
`import_product_reference_pack`	assets	No	No
`create_canvas_workflow`	recipes	No	No
`run_canvas_workflow`	recipes	No	Yes
`get_canvas_workflow_run`	runs	No	No
`generate_image_in_canvas`	images	No	Yes
`find_video_models`	models	Yes	No
`generate_video`	videos	No	Yes
`get_video_job`	runs	No	No
`element_archive`	elements	No	No
`element_collection_create`	elements	No	No
`element_collection_delete`	elements	No	No
`element_collection_list`	elements	Yes	No
`element_collection_update`	elements	No	No
`element_create`	elements	No	No
`element_get`	elements	Yes	No
`element_history`	elements	Yes	No
`element_list`	elements	Yes	No
`element_restore`	elements	No	No
`element_update`	elements	No	No
`element_update_collections`	elements	No	No

Read-only tools

12 of 29 tools do not mutate canvas state, generate media, or spend credit:

guide_search
guide_get
canvas_list
canvas_get
canvas_validate
get_canvas_image
open_canvas
find_video_models
element_collection_list
element_get
element_history
element_list

Tools that can spend provider credit

Ask for explicit current-turn approval before calling any of these, and never retry one automatically after a failure:

run_canvas_workflow
generate_image_in_canvas
generate_video

By toolset

canvas

Canvas graph reading and editing, node and connection operations, and the in-product agent guide.

guide_search
guide_get
canvas_list
canvas_get
canvas_validate
canvas_apply_batch
open_canvas

recipes

Recipe Library discovery, forking, and explicit Recipe runs.

create_canvas_workflow
run_canvas_workflow

assets

Durable asset reads and uploads.

get_canvas_image
save_image_to_canvas
import_product_reference_pack

elements

Reusable immutable-version visual references and their user-defined collections.

element_archive
element_collection_create
element_collection_delete
element_collection_list
element_collection_update
element_create
element_get
element_history
element_list
element_restore
element_update
element_update_collections

models

Runnable model and saved provider connection discovery.

find_video_models

images

Image generation, editing, and variation jobs.

generate_image_in_canvas

videos

Video generation jobs.

generate_video

runs

Job and Run observation, waiting, and cancellation.

get_canvas_workflow_run
get_video_job