image_add
DestructiveIdempotent
Add a still image—photo, logo, or sticker—from common formats into the project, with EXIF rotation applied so it displays upright, and use it in cues or as an overlay.
Instructions
Add a still image to the project: a photo, a logo, a cut-out sticker.
It lands upright (a phone photo's EXIF rotation applied) in a format the render and the window both read. Then show it full frame with cue_add(asset="image:"), or place it over the film as a sticker with overlay_add(image=name, x=, y=, width=, rotate=, style="photo").
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| name | No | What to call it; `image:<name>` is how a cue names it. Unset, from the filename. | |
| path | No | The project directory to act on. Omit it — the usual case — when this server is bound to a project (started as `proofcut -C DIR mcp`, or inside a project; `ping` says which): it then resolves to that one bound project, a relative path resolves against it, and a path outside it is refused by name. Unbound, `path` is the whole address and omitting it refuses rather than guessing. | |
| source | Yes | The image file: PNG, JPEG, WebP, HEIC, GIF (its first frame), AVIF, TIFF or BMP. list_media lists the ones in a folder under `images`. | |
| replace | No | Replace an image of this name. Unset, a taken name is refused. |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||