MCP ToolsArtist & Critique
compare_sketches
Side-by-side capture of 2-4 sketches with comparison framework.
Input Schema
| Parameter | Type | Required | Description |
|---|---|---|---|
sketchIds | array of string | Yes | IDs of the sketches to compare. Must contain 2 to 4 entries. |
aspects | array of "composition" | "color" | "rhythm" | "unity" | "expression" | No | Which aspects to compare across sketches. Defaults to all five. |
previewSize | number | No | Size in pixels for each captured screenshot. Default: 300. |
Output Shape
{
"screenshots": {
"<sketchId>": "<base64 image>"
},
"comparison": {
"aspects": [
{
"name": "composition",
"perSketch": {
"<sketchId>": "..."
},
"synthesis": "..."
}
]
}
}Side Effects
- Captures a screenshot of each sketch at the requested preview size.
Error Cases
| Error | Cause |
|---|---|
Sketch not found | One or more of the provided sketchIds do not match any saved sketch. |
Too few sketches | Fewer than 2 sketch IDs were provided. |
Too many sketches | More than 4 sketch IDs were provided. |
Invalid aspect | An unrecognized aspect string was included in the aspects array. |
Golden Path Example
Request
{
"sketchIds": ["sketch-a", "sketch-b"],
"aspects": ["color", "rhythm"],
"previewSize": 300
}Response
{
"screenshots": {
"sketch-a": "<base64 image>",
"sketch-b": "<base64 image>"
},
"comparison": {
"aspects": [
{
"name": "color",
"perSketch": {
"sketch-a": "Muted earth tones with high value contrast.",
"sketch-b": "Saturated primaries with low value contrast."
},
"synthesis": "sketch-a achieves depth through value while sketch-b relies on hue separation."
},
{
"name": "rhythm",
"perSketch": {
"sketch-a": "Regular, grid-based repetition.",
"sketch-b": "Organic, irregular spacing."
},
"synthesis": "The regularity in sketch-a feels mechanical; sketch-b has more visual energy but risks chaos."
}
]
}
}