execute_commands
Execute multiple canvas design commands by ID in sequence, stopping at the first error, and optionally return PNG previews to visually verify results before continuing.
Instructions
Execute one or more commands by ID. Accepts an array of commands that share a single canvasId. Commands run sequentially, stopping on first error. Use command IDs from the skill docs. Pass previewIds + previewScale: 2 for inline PNG verification. Visually inspect every preview, describe what you see, fix issues. (External MCP clients: call init first for usage docs. Hosted-CLI and sub-agents have docs pre-loaded.)
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"commands": "<commands>"
},
"name": "execute_commands"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| ids | No | Optional: element IDs applied to every command in the batch that names none of its own. The per-command `commands[i].ids` always wins. `elementIds` is accepted as an alias. | |
| project | No | Optional: run THIS call against a project other than the session's bound one: a name or key from list_projects (or an unambiguous name/handle substring), or the absolute path of a project folder (one holding .bl files, or an empty one), which opens in the background and is added to list_projects. Unknown/ambiguous is refused with candidates. | |
| canvasId | No | Target canvas ID. Required for every canvas-scoped verb (enforced at dispatch, refused by name when missing); the workspace/app-level verbs (get_canvases, create_canvas, create_folder, list_keybindings, the library acts, ...) are exempt and need none. | |
| commands | Yes | Array of commands to execute sequentially. | |
| sessionId | No | Session ID for per-session visual feedback. Optional. | |
| previewIds | No | Element IDs to include in a PNG preview returned alongside the summary. Omit for no preview. | |
| previewScale | No | Scale factor for the preview image (default 1.0, max 3.0). Use 2.0 for verifying visual details like text or alignment. |