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.

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_list, image_studio_create, image_studio_get, image_studio_edit, 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_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_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_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. 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_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_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_list, image_studio_create, image_studio_get, image_studio_edit, image_studio_accept, image_studio_branch.