MCP ToolsArtist & Critique
update_reference_analysis
Save structured analysis back to reference.
Input Schema
| Parameter | Type | Required | Description |
|---|---|---|---|
referenceId | string | Yes | ID of the reference to update. |
seriesId | string | No | ID of the series the reference belongs to. |
sketchId | string | No | ID of the sketch the reference is attached to. |
analysis | object | Yes | Structured analysis to save. All fields are optional. |
analysis.composition | string | No | Compositional analysis. |
analysis.palette | string | No | Palette and color analysis. |
analysis.rhythm | string | No | Rhythm and repetition analysis. |
analysis.mood | string | No | Mood and emotional quality analysis. |
analysis.technique | string | No | Technique and execution analysis. |
analysis.keyQualities | array of string | No | Key visual qualities identified. |
Output Shape
{
"referenceId": "ref-hk4701",
"updated": true,
"analysis": {
"composition": "...",
"palette": "...",
"rhythm": "...",
"mood": "...",
"technique": "...",
"keyQualities": ["..."]
}
}Side Effects
- Persists the analysis data to the reference record in the workspace.
Error Cases
| Error | Cause |
|---|---|
Reference not found | The provided referenceId does not match any stored reference. |
Analysis is required | The analysis parameter was missing or empty. |
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",
"analysis": {
"composition": "Central radial symmetry with concentric rings.",
"palette": "Warm yellows and oranges with cool blue accents.",
"keyQualities": ["radial symmetry", "flat color", "spiritual geometry"]
}
}Response
{
"referenceId": "ref-hk4701",
"updated": true,
"analysis": {
"composition": "Central radial symmetry with concentric rings.",
"palette": "Warm yellows and oranges with cool blue accents.",
"rhythm": null,
"mood": null,
"technique": null,
"keyQualities": ["radial symmetry", "flat color", "spiritual geometry"]
}
}