MCP tools

All tools are called with JSON-RPC tools/call and their arguments are validated against the schema returned by tools/list.

Generate & edit

Tool	Required arguments	Purpose
generate_image	model_path, prompt	Queue-backed synchronous text-to-image
start_generate_image	model_path, prompt	Start an asynchronous generation
get_job_status	job_id	Poll an asynchronous job
get_job_result	job_id	Fetch a completed job result
img2img	model_path, init_image_id, prompt	Generate a variation
design_edit	backend, image_id, instruction	Instruction-based design edit
inpaint	model_path, image_id, prompt	Repaint a masked region
inpaint_with_mask	model_path, image_id, mask_image_id, prompt	Repaint with an explicit mask
create_mask	width, height	Create a black mask with an optional white region

For masks, white means repaint and black means keep.

Images, models & plugins

Tool	Required arguments	Purpose
list_models	kind	List checkpoints, LoRAs, VAEs, CLIP, or ControlNet models
get_image	image_id	Fetch thumbnail or full image bytes
save_asset	source, asset_name	Save an image to the project asset library
remove_background	image_id	Remove an image background
list_plugins	—	List available ML plugins
run_plugin	plugin_name, image_id	Run a named plugin

Use mode: "thumbnail" with get_image for agent workflows unless full resolution is required.

Shared documents & history

Tool	Required arguments	Purpose
open_document	image_id	Open or create a document rooted at an image
get_document	document_id	Read document head metadata
list_edits	document_id	List document edits
stroke	document_id, path, brush	Commit a brush stroke and append an edit
undo	document_id	Move the document cursor backward
redo	document_id	Move the document cursor forward

stroke.path is an array of {x, y} points. brush includes size, hardness, color_rgba, and blend (normal or erase).