MCP ToolsArtist & Critique
promote_sketch
Promote sketch to next stage — fork, upscale, update compositionLevel.
Input Schema
| Parameter | Type | Required | Description |
|---|---|---|---|
sketchId | string | Yes | ID of the sketch to promote. |
toStage | "studies" | "drafts" | "refinements" | "finals" | Yes | Target stage to promote the sketch to. |
seriesId | string | No | ID of the series the sketch belongs to. |
newId | string | No | Custom ID for the promoted (forked) sketch. Auto-generated if omitted. |
title | string | No | Title for the promoted sketch. Inherits from the original if omitted. |
Output Shape
{
"originalId": "sketch-001",
"promotedId": "sketch-001-draft",
"toStage": "drafts",
"compositionLevel": 2,
"seriesId": "series-e7f2a1"
}Side Effects
- Forks the original sketch into a new sketch at the target stage.
- Updates the
compositionLevelon the new sketch to match the target stage. - If
seriesIdis provided, adds the promoted sketch to that series under the target stage.
Error Cases
| Error | Cause |
|---|---|
Sketch not found | The provided sketchId does not match any saved sketch. |
Invalid stage | The toStage value is not one of the recognized stages. |
Series not found | The provided seriesId does not match any existing series. |
Already at stage | The sketch is already at or beyond the target stage. |
Golden Path Example
Request
{
"sketchId": "sketch-001",
"toStage": "drafts",
"seriesId": "series-e7f2a1",
"title": "Circle Erosion — Draft"
}Response
{
"originalId": "sketch-001",
"promotedId": "sketch-001-draft-a3f1",
"toStage": "drafts",
"compositionLevel": 2,
"seriesId": "series-e7f2a1"
}