MCP ToolsSpatial Arrangement
group_sketches
Create or update a named group of sketches in the workspace for organizational purposes.
Input Schema
| Parameter | Type | Required | Description |
|---|---|---|---|
groupId | string | yes | Unique group identifier |
label | string | yes | Display label for the group |
sketchIds | string[] | yes | IDs of sketches to include in the group |
color | string | no | Optional group color (hex string) |
Output Shape
{
"success": true,
"group": {
"id": "warm-tones",
"label": "Warm Tones",
"sketchFiles": ["noise-grid.genart", "flow-field.genart"],
"color": "#FF9800"
},
"groupCount": 2
}Side Effects
- Updates (or creates) a group entry in the
.genart-workspacefile - If a group with the same ID already exists, it is replaced
- Does not modify any
.genartfiles
Error Cases
| Condition | Error |
|---|---|
| No workspace open | "No workspace is currently open" |
| Unknown sketch ID | "Sketch not found: 'bad-id'" |
| Empty sketchIds array | "At least one sketch ID is required" |
Golden Path Example
Request:
{
"groupId": "warm-tones",
"label": "Warm Tones",
"sketchIds": ["noise-grid", "flow-field"],
"color": "#FF9800"
}Response:
{
"success": true,
"group": {
"id": "warm-tones",
"label": "Warm Tones",
"sketchFiles": ["noise-grid.genart", "flow-field.genart"],
"color": "#FF9800"
},
"groupCount": 1
}