get_selection
Retrieve selected element IDs and blueprint data from a canvas; large selections are summarized with counts, bounds, and IDs so you can read full subtrees.
Instructions
Get the IDs and blueprint of currently selected elements on a specific canvas. Returns selected element IDs and their blueprint representation including descendants. A selection past 1,000 elements (descendants included) is summarized: counts by type (countsByType), union bounds (worldBounds), the first 100 ids and a note, beside the true count. Use read with a scope of ids or #refs for full subtrees. (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": {
"canvasId": "<canvasId>"
},
"name": "get_selection"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| 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 | Yes | Canvas ID to get selection from. REQUIRED. |