Local tools reference

The local stdio MCP server exposes 57 tools across 10 toolsets. It runs on your machine through the Gavana CLI, so it authenticates with your saved CLI profile or an Agent Access token rather than browser OAuth, and it reaches the same /api/canvas-agent/v1 operations the CLI uses.

Read-only and paid flags are machine-declared only for the hosted surface. Where a local tool shares a name with a hosted tool the declared flags are shown; otherwise the column reads “Not declared” rather than guessing. Judge an undeclared tool by the API operation behind it — the image_, video_, and recipe_run tools reach paid provider work.

All local tools

Tool	Toolset	Also hosted	Read-only	Can incur provider cost
`action_get`	actions	No	Not declared	Not declared
`action_list`	actions	No	Not declared	Not declared
`action_run`	actions	No	Not declared	Not declared
`agent_canvas_get`	canvas	No	Not declared	Not declared
`asset_get`	assets	No	Not declared	Not declared
`asset_list`	assets	No	Not declared	Not declared
`asset_upload`	assets	No	Not declared	Not declared
`campaign_cancel`	campaigns	No	Not declared	Not declared
`campaign_get`	campaigns	No	Not declared	Not declared
`campaign_plan`	campaigns	No	Not declared	Not declared
`campaign_review`	campaigns	No	Not declared	Not declared
`campaign_start`	campaigns	No	Not declared	Not declared
`canvas_apply_batch`	canvas	Yes	No	No
`canvas_create`	canvas	No	Not declared	Not declared
`canvas_get`	canvas	Yes	Yes	No
`canvas_list`	canvas	Yes	Yes	No
`canvas_render`	canvas	No	Not declared	Not declared
`canvas_validate`	canvas	Yes	Yes	No
`connection_create`	canvas	No	Not declared	Not declared
`connection_delete`	canvas	No	Not declared	Not declared
`element_archive`	elements	Yes	No	No
`element_collection_create`	elements	Yes	No	No
`element_collection_delete`	elements	Yes	No	No
`element_collection_list`	elements	Yes	Yes	No
`element_collection_update`	elements	Yes	No	No
`element_create`	elements	Yes	No	No
`element_get`	elements	Yes	Yes	No
`element_history`	elements	Yes	Yes	No
`element_list`	elements	Yes	Yes	No
`element_restore`	elements	Yes	No	No
`element_update`	elements	Yes	No	No
`element_update_collections`	elements	Yes	No	No
`guide_get`	canvas	Yes	Yes	No
`guide_search`	canvas	Yes	Yes	No
`image_edit`	images	No	Not declared	Not declared
`image_generate`	images	No	Not declared	Not declared
`image_variations`	images	No	Not declared	Not declared
`job_cancel`	runs	No	Not declared	Not declared
`job_get`	runs	No	Not declared	Not declared
`job_wait`	runs	No	Not declared	Not declared
`model_get`	models	No	Not declared	Not declared
`model_list`	models	No	Not declared	Not declared
`node_create`	canvas	No	Not declared	Not declared
`node_delete`	canvas	No	Not declared	Not declared
`node_get`	canvas	No	Not declared	Not declared
`node_move`	canvas	No	Not declared	Not declared
`node_resize`	canvas	No	Not declared	Not declared
`node_update`	canvas	No	Not declared	Not declared
`provider_list`	models	No	Not declared	Not declared
`recipe_fork`	recipes	No	Not declared	Not declared
`recipe_get`	recipes	No	Not declared	Not declared
`recipe_run`	recipes	No	Not declared	Not declared
`recipe_search`	recipes	No	Not declared	Not declared
`run_cancel`	runs	No	Not declared	Not declared
`run_get`	runs	No	Not declared	Not declared
`run_wait`	runs	No	Not declared	Not declared
`video_generate`	videos	No	Not declared	Not declared

By toolset

canvas (17 tools)

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

Tool	Also hosted
`agent_canvas_get`	No
`canvas_apply_batch`	Yes
`canvas_create`	No
`canvas_get`	Yes
`canvas_list`	Yes
`canvas_render`	No
`canvas_validate`	Yes
`connection_create`	No
`connection_delete`	No
`guide_get`	Yes
`guide_search`	Yes
`node_create`	No
`node_delete`	No
`node_get`	No
`node_move`	No
`node_resize`	No
`node_update`	No

recipes (4 tools)

Recipe Library discovery, forking, and explicit Recipe runs.

Tool	Also hosted
`recipe_fork`	No
`recipe_get`	No
`recipe_run`	No
`recipe_search`	No

assets (3 tools)

Durable asset reads and uploads.

Tool	Also hosted
`asset_get`	No
`asset_list`	No
`asset_upload`	No

elements (12 tools)

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

Tool	Also hosted
`element_archive`	Yes
`element_collection_create`	Yes
`element_collection_delete`	Yes
`element_collection_list`	Yes
`element_collection_update`	Yes
`element_create`	Yes
`element_get`	Yes
`element_history`	Yes
`element_list`	Yes
`element_restore`	Yes
`element_update`	Yes
`element_update_collections`	Yes

models (3 tools)

Runnable model and saved provider connection discovery.

Tool	Also hosted
`model_get`	No
`model_list`	No
`provider_list`	No

actions (3 tools)

Deterministic, credit-free image transformations.

Tool	Also hosted
`action_get`	No
`action_list`	No
`action_run`	No

images (3 tools)

Image generation, editing, and variation jobs.

Tool	Also hosted
`image_edit`	No
`image_generate`	No
`image_variations`	No

videos (1 tools)

Video generation jobs.

Tool	Also hosted
`video_generate`	No

runs (6 tools)

Job and Run observation, waiting, and cancellation.

Tool	Also hosted
`job_cancel`	No
`job_get`	No
`job_wait`	No
`run_cancel`	No
`run_get`	No
`run_wait`	No

campaigns (5 tools)

Deprecated campaign compatibility surface.

Tool	Also hosted
`campaign_cancel`	No
`campaign_get`	No
`campaign_plan`	No
`campaign_review`	No
`campaign_start`	No

Tools that exist locally but not on the hosted server

39 tools have no hosted equivalent. Reach for a local server when you need these:

action_get (actions)
action_list (actions)
action_run (actions)
agent_canvas_get (canvas)
asset_get (assets)
asset_list (assets)
asset_upload (assets)
campaign_cancel (campaigns)
campaign_get (campaigns)
campaign_plan (campaigns)
campaign_review (campaigns)
campaign_start (campaigns)
canvas_create (canvas)
canvas_render (canvas)
connection_create (canvas)
connection_delete (canvas)
image_edit (images)
image_generate (images)
image_variations (images)
job_cancel (runs)
job_get (runs)
job_wait (runs)
model_get (models)
model_list (models)
node_create (canvas)
node_delete (canvas)
node_get (canvas)
node_move (canvas)
node_resize (canvas)
node_update (canvas)
provider_list (models)
recipe_fork (recipes)
recipe_get (recipes)
recipe_run (recipes)
recipe_search (recipes)
run_cancel (runs)
run_get (runs)
run_wait (runs)
video_generate (videos)