MCP tools: remote-image-studio

All tool groups

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.

ParameterTypeRequiredDescription
projectIdstringyes
sessionIdstringyes
versionIdstringyes
expectedAcceptedVersionIdstring \nullyes

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.

ParameterTypeRequiredDescription
projectIdstringyes
attachmentIdstringyes
destination"reference" \"chat" \"ticket"
conversationIdstringno
issueIdstringno
operationIdstringyes
bodystringno
readOnlybooleannoInspect this exact operation only. Required after an unknown outcome; never repeats copy or delivery.
approvalIdstringnoServer-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.

ParameterTypeRequiredDescription
projectIdstringyes
sessionIdstringyes
versionIdstringyes
expectedAcceptedVersionIdstring \nullyes

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.

ParameterTypeRequiredDescription
projectIdstringyes
briefstringyes
locksobjectno
sheetAttachmentIdsstring[]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.

ParameterTypeRequiredDescription
projectIdstringyes
sessionIdstringyes
operationIdstringyes
instructionstringyes
expectedAcceptedVersionIdstring \nullyes
maskAttachmentIdstringno
size"1024x1024" \"1536x1024" \"1024x1536"
quality"low" \"medium" \"high"
regionobjectno
variantsintegerno

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.

ParameterTypeRequiredDescription
projectIdstringyes
sessionIdstringyes

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.

ParameterTypeRequiredDescription
projectIdstringyes

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.

ParameterTypeRequiredDescription
projectIdstringyes
sessionIdstringyes
versionIdstringyes
expectedAcceptedVersionIdstring \nullyes

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.

We use essential cookies to keep you signed in. See our Privacy Policy for details.