MCP ToolsWorkspace Management
list_workspace_sketches
List all sketches in the active workspace with metadata summaries.
Input Schema
| Parameter | Type | Required | Description |
|---|---|---|---|
includeState | boolean | no | Include current seed, params, and colorPalette (default: false) |
Output Shape
{
"success": true,
"workspace": {
"id": "typography-explorations",
"title": "Typography Explorations",
"path": "/absolute/path/to/ws.genart-workspace"
},
"sketchCount": 2,
"sketches": [
{
"file": "orchestrated-opposition.genart",
"position": { "x": 0, "y": 0 },
"label": "v1 - Grid Contrasts",
"id": "orchestrated-opposition",
"title": "Orchestrated Opposition",
"renderer": "p5",
"canvas": { "width": 1200, "height": 1200 },
"parameterCount": 4,
"colorCount": 3,
"locked": false,
"visible": true
}
]
}When includeState is true, each sketch entry also includes:
{
"state": {
"seed": 12345,
"params": { "margin": 60 },
"colorPalette": ["#1a1a1a", "#f5f0eb"]
}
}Side Effects
None. Read-only.
Error Cases
| Condition | Error |
|---|---|
| No workspace open | "No workspace is currently open" |
Golden Path Example
Request:
{
"includeState": false
}Response: (as shown in Output Shape above)