MCP ToolsArtist & Critique
analyze_reference
Return structured analysis framework for a reference.
Input Schema
| Parameter | Type | Required | Description |
|---|---|---|---|
referenceId | string | Yes | ID of the reference to analyze. |
seriesId | string | No | ID of the series the reference belongs to. |
sketchId | string | No | ID of the sketch the reference is attached to. |
previewSize | number | No | Size in pixels for the reference preview image. |
Output Shape
{
"referenceId": "ref-hk4701",
"preview": "<base64 image>",
"analysis": {
"composition": "...",
"palette": "...",
"rhythm": "...",
"mood": "...",
"technique": "...",
"keyQualities": ["..."]
}
}Side Effects
- Generates a preview image of the reference at the requested size.
Error Cases
| Error | Cause |
|---|---|
Reference not found | The provided referenceId does not match any stored reference. |
Series not found | The provided seriesId does not match any existing series. |
Sketch not found | The provided sketchId does not match any saved sketch. |
Golden Path Example
Request
{
"referenceId": "ref-hk4701",
"seriesId": "series-e7f2a1",
"previewSize": 400
}Response
{
"referenceId": "ref-hk4701",
"preview": "<base64 image>",
"analysis": {
"composition": "Central radial symmetry with concentric rings. The eye is drawn inward.",
"palette": "Warm yellows and oranges dominate, with cool blue accents at the periphery.",
"rhythm": "Concentric repetition creates a pulsing, meditative rhythm.",
"mood": "Contemplative and spiritual. A sense of unfolding or revelation.",
"technique": "Flat color fields with precise geometric boundaries. Minimal blending.",
"keyQualities": ["radial symmetry", "flat color", "spiritual geometry", "warm-cool contrast"]
}
}