image_add
Adds an image layer to a design canvas from a local file, public URL, or Base64 data, with options for position, rotation, opacity, scaling, and full-bleed background.
Instructions
Adds an image layer to the canvas. Source can be ANY local file path on the user computer (e.g. "C:/path/to/img.png" or "workspace-assets/photo.jpg"), an external public URL (e.g. Unsplash), or a Base64 data URL. Set isBackground: true to automatically make it a full-bleed background.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"src": "<src>"
},
"name": "image_add"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| x | No | X coordinate (defaults to canvas center) | |
| y | No | Y coordinate (defaults to canvas center) | |
| src | Yes | Local image path on computer, web URL, or Base64 data URL | |
| angle | No | Rotation angle in degrees | |
| opacity | No | Opacity from 0 to 1 | |
| isBackground | No | When true, sends layer to back as a background graphic | |
| scaleToWidth | No | Scale image to specific width in pixels |