Tool tree
gradeNot graded
get_workspaceAnswer
Start here. Returns the current revision and the IDs of datasets, relationships, visualizations, filters, metrics, and selections, without row values. Most other tools need IDs from this call. When a section total exceeds the entries returned, call again with section plus offset to reach the rest. Call it after a write to confirm the result and get the revision for the next expectedRevision. A changed toolContractVersion means argument shapes changed. Column names come from get_dataset_schema.
View tool JSON
{
"name": "get_workspace",
"kind": "answer",
"impl": "imperative",
"description": "Start here. Returns the current revision and the IDs of datasets, relationships, visualizations, filters, metrics, and selections, without row values. Most other tools need IDs from this call. When a section total exceeds the entries returned, call again with section plus offset to reach the rest. Call it after a write to confirm the result and get the revision for the next expectedRevision. A changed toolContractVersion means argument shapes changed. Column names come from get_dataset_schema.",
"inputSchema": {
"type": "object",
"properties": {
"section": {
"type": "string",
"enum": [
"datasets",
"relationships",
"visualizations",
"filters",
"metrics",
"selections"
],
"description": "Return only this section, paged with offset and limit, when the overview reports more entries than it returned. Omit for all sections."
},
"offset": {
"type": "integer",
"minimum": 0,
"description": "Index of the first entry to return from section. Defaults to 0."
},
"limit": {
"type": "integer",
"minimum": 1,
"maximum": 50,
"description": "Maximum entries to return from section. Defaults to 25."
}
},
"required": [],
"additionalProperties": false
}
}clear_selectionAction
Remove the row emphasis created by highlight_selection, returning every chart to its unselected state. Pass a datasetId to clear one dataset, or omit it to clear every selection, including one a human made. This affects highlighting only and never removes filters; use clear_filters for those.
View tool JSON
{
"name": "clear_selection",
"kind": "act",
"impl": "imperative",
"description": "Remove the row emphasis created by highlight_selection, returning every chart to its unselected state. Pass a datasetId to clear one dataset, or omit it to clear every selection, including one a human made. This affects highlighting only and never removes filters; use clear_filters for those.",
"inputSchema": {
"type": "object",
"properties": {
"datasetId": {
"type": "string",
"minLength": 1,
"maxLength": 100,
"description": "Clears only the selection on this dataset. Omit to clear every selection in the workspace, including one a human made."
},
"expectedRevision": {
"type": "integer",
"minimum": 0,
"description": "Revision from get_workspace this call assumes. Fails with STALE_WORKSPACE_REVISION if it moved on. Omit to apply unconditionally."
}
},
"additionalProperties": false
}
}undoAction
Reverse the most recent reversible workspace change, whether a human or agent made it. Each call steps back one action, so call it repeatedly to unwind several. Prefer a targeted correction such as update_visualization or clear_filters when you know what to change, because undo may revert a later human edit.
View tool JSON
{
"name": "undo",
"kind": "act",
"impl": "imperative",
"description": "Reverse the most recent reversible workspace change, whether a human or agent made it. Each call steps back one action, so call it repeatedly to unwind several. Prefer a targeted correction such as update_visualization or clear_filters when you know what to change, because undo may revert a later human edit.",
"inputSchema": {
"type": "object",
"properties": {
"expectedRevision": {
"type": "integer",
"minimum": 0,
"description": "Revision from get_workspace this call assumes. Fails with STALE_WORKSPACE_REVISION if it moved on, so a later edit is not reverted by mistake."
}
},
"additionalProperties": false
}
}redoAction
Reapply the change most recently reversed by undo. Use it only after undo. A new workspace change clears the redo history.
View tool JSON
{
"name": "redo",
"kind": "act",
"impl": "imperative",
"description": "Reapply the change most recently reversed by undo. Use it only after undo. A new workspace change clears the redo history.",
"inputSchema": {
"type": "object",
"properties": {
"expectedRevision": {
"type": "integer",
"minimum": 0,
"description": "Revision from get_workspace this call assumes. Fails with STALE_WORKSPACE_REVISION if it moved on, so a later edit is not reverted by mistake."
}
},
"additionalProperties": false
}
}