MCP tools: remote-image-studio
remote-image-studio
Registered when: IMAGE_STUDIO_ENABLED (on by default); org ai.enabled for listing; project ai:use enforced on every call.
image_studio_accept
accept a completed image version. Keeps all previous nodes. Ask the person which image to keep before accepting.
| Parameter | Type | Required | Description |
|---|---|---|---|
projectId | string | yes | |
sessionId | string | yes | |
versionId | string | yes | |
expectedAcceptedVersionId | string \ | null | yes |
Example call:
{"name":"image_studio_accept","arguments":{"projectId":"<projectId>","sessionId":"<sessionId>","versionId":"<versionId>","expectedAcceptedVersionId":"<expectedAcceptedVersionId>"}}
Related: image_studio_attach, image_studio_list, image_studio_create, image_studio_get, image_studio_edit, image_studio_revert, image_studio_branch.
image_studio_attach
Copy a readable completed image into a project as a reference, or attach a real copy to a named chat or ticket. The original keeps its owner. For editing a DM image: copy as reference, use its returned attachment.id in image_studio_create sheetAttachmentIds, then image_studio_edit. Deliver generated attachmentId with this tool; a filename in reply text is not an attachment. Never claim delivery when this tool returns an error.
| Parameter | Type | Required | Description |
|---|---|---|---|
projectId | string | yes | |
attachmentId | string | yes | |
destination | "reference" \ | "chat" \ | "ticket" |
conversationId | string | no | |
issueId | string | no | |
operationId | string | yes | |
body | string | no | |
readOnly | boolean | no | Inspect this exact operation only. Required after an unknown outcome; never repeats copy or delivery. |
approvalId | string | no | Server-issued approval for this exact copy or delivery. Consumed approvals permit only committed-result inspection. |
Example call:
{"name":"image_studio_attach","arguments":{"projectId":"<projectId>","attachmentId":"<attachmentId>","destination":"reference","operationId":"<operationId>"}}
Related: image_studio_list, image_studio_create, image_studio_get, image_studio_edit, image_studio_accept, image_studio_revert, image_studio_branch.
image_studio_branch
branch a completed image version. Keeps all previous nodes. Ask the person which image to keep before accepting.
| Parameter | Type | Required | Description |
|---|---|---|---|
projectId | string | yes | |
sessionId | string | yes | |
versionId | string | yes | |
expectedAcceptedVersionId | string \ | null | yes |
Example call:
{"name":"image_studio_branch","arguments":{"projectId":"<projectId>","sessionId":"<sessionId>","versionId":"<versionId>","expectedAcceptedVersionId":"<expectedAcceptedVersionId>"}}
Related: image_studio_attach, image_studio_list, image_studio_create, image_studio_get, image_studio_edit, image_studio_accept, image_studio_revert.
image_studio_create
Create a locked brief with subject/palette/composition/style/text pins and reusable character/product sheet attachments. New versions are candidates until accepted.
| Parameter | Type | Required | Description |
|---|---|---|---|
projectId | string | yes | |
brief | string | yes | |
locks | object | no | |
sheetAttachmentIds | string[] | no |
Example call:
{"name":"image_studio_create","arguments":{"projectId":"<projectId>","brief":"<brief>"}}
Related: image_studio_attach, image_studio_list, image_studio_get, image_studio_edit, image_studio_accept, image_studio_revert, image_studio_branch.
image_studio_edit
Generate a candidate using the last ACCEPTED image as the reference. One narrow instruction. Optional region {x,y,width,height} (0..1 of the image): only that part changes, every pixel outside it is kept from the accepted image. Optional variants 1-4: several candidates of the same change, show them all and ask which to keep. Costs are capped. Use a stable operationId across retries and expectedAcceptedVersionId from image_studio_get.
| Parameter | Type | Required | Description |
|---|---|---|---|
projectId | string | yes | |
sessionId | string | yes | |
operationId | string | yes | |
instruction | string | yes | |
expectedAcceptedVersionId | string \ | null | yes |
maskAttachmentId | string | no | |
size | "1024x1024" \ | "1536x1024" \ | "1024x1536" |
quality | "low" \ | "medium" \ | "high" |
region | object | no | |
variants | integer | no |
Example call:
{"name":"image_studio_edit","arguments":{"projectId":"<projectId>","sessionId":"<sessionId>","operationId":"<operationId>","instruction":"<instruction>","expectedAcceptedVersionId":"<expectedAcceptedVersionId>"}}
Related: image_studio_attach, image_studio_list, image_studio_create, image_studio_get, image_studio_accept, image_studio_revert, image_studio_branch.
image_studio_get
Read complete image lineage, prompts, references, provider, cost and drift warnings without changing image state. Overdue reservation warnings leave worker outcome and final charge unconfirmed; this read does not stop or retry work. Compare the attachment images before accepting.
| Parameter | Type | Required | Description |
|---|---|---|---|
projectId | string | yes | |
sessionId | string | yes |
Example call:
{"name":"image_studio_get","arguments":{"projectId":"<projectId>","sessionId":"<sessionId>"}}
Related: image_studio_attach, image_studio_list, image_studio_create, image_studio_edit, image_studio_accept, image_studio_revert, image_studio_branch.
image_studio_list
List project image sessions and spend cap.
| Parameter | Type | Required | Description |
|---|---|---|---|
projectId | string | yes |
Example call:
{"name":"image_studio_list","arguments":{"projectId":"<projectId>"}}
Related: image_studio_attach, image_studio_create, image_studio_get, image_studio_edit, image_studio_accept, image_studio_revert, image_studio_branch.
image_studio_revert
revert a completed image version. Keeps all previous nodes. Ask the person which image to keep before accepting.
| Parameter | Type | Required | Description |
|---|---|---|---|
projectId | string | yes | |
sessionId | string | yes | |
versionId | string | yes | |
expectedAcceptedVersionId | string \ | null | yes |
Example call:
{"name":"image_studio_revert","arguments":{"projectId":"<projectId>","sessionId":"<sessionId>","versionId":"<versionId>","expectedAcceptedVersionId":"<expectedAcceptedVersionId>"}}
Related: image_studio_attach, image_studio_list, image_studio_create, image_studio_get, image_studio_edit, image_studio_accept, image_studio_branch.