MCP ToolsArtist & Critique
add_reference
Import image as reference for inspiration.
Input Schema
| Parameter | Type | Required | Description |
|---|---|---|---|
image | string | Yes | File path or URL of the image to import as a reference. |
type | "image" | "artwork" | "photograph" | "texture" | "palette" | No | Classification of the reference material. |
source | string | No | Attribution or source description for the reference. |
seriesId | string | No | ID of the series to attach the reference to. |
sketchId | string | No | ID of a specific sketch to attach the reference to. |
id | string | No | Custom ID for the reference. Auto-generated if omitted. |
Output Shape
{
"referenceId": "ref-abc123",
"type": "artwork",
"source": "Hilma af Klint, Group IV, No. 3",
"attachedTo": {
"seriesId": "series-e7f2a1",
"sketchId": null
}
}Side Effects
- Imports and stores the image as a reference in the workspace.
- Attaches the reference to the specified series or sketch if provided.
Error Cases
| Error | Cause |
|---|---|
Image is required | The image parameter was empty or missing. |
Image not found | The file path does not point to an existing file. |
Invalid image URL | The URL could not be fetched or is not a valid image. |
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
{
"image": "/Users/me/references/hilma-af-klint-group-iv.jpg",
"type": "artwork",
"source": "Hilma af Klint, Group IV, No. 3",
"seriesId": "series-e7f2a1"
}Response
{
"referenceId": "ref-hk4701",
"type": "artwork",
"source": "Hilma af Klint, Group IV, No. 3",
"attachedTo": {
"seriesId": "series-e7f2a1",
"sketchId": null
}
}