MCP tool reference

Input contracts, permissions and declared response schemas generated from SIA Studio’s shared source.

Generated from the shared workflow contracts for gateway release 0.8.3. This source catalog contains 70 workflow tools, plus the account/profile and workflow guide tools described below. It is not a claim that every tool is enabled for every runtime or authorized connection. Use live MCP discovery and the server’s authorization responses.

​

Account and guidance tools

• account_get: no arguments; identifies the SIA account and client attached to the current authorization. Requires account:read.
• profile_get: no arguments; returns the connected account’s stable profile identifier and optional name/email. Requires account:read.
• workflow_guide_get: reads the supported workflow guide. Requires an authenticated account:read connection. Its live input schema is advertised through MCP discovery.

These are read-only operations. Account and tenant identifiers are derived by the server, not selected by a caller argument.

​

Response contracts

Each tool has its own page with input and declared success schemas. These are not exhaustive response examples. Additional fields are allowed where the schema says so. Production output contracts are currently partial: their versioned envelope does not specify the complete Production receipt. A queued job is not completed media. Error content, OAuth challenges and binary media blocks are separate MCP protocol results.

Download the machine-readable workflow catalog. It contains no account data or credentials.

​

Library

Tool	Purpose	Permission
library_search	Search saved Studio work	studio:read
library_status	Check the saved-work change watermark	studio:read

​

Storyworlds

Tool	Purpose	Permission
storyworld_create	Create a Storyworld	studio:write
storyworld_list	Find your Storyworlds	studio:read

​

Characters

Tool	Purpose	Permission
character_audition_generate	Generate one Character audio audition	studio:generate
character_cast_draft	Cast a character draft from a saved reference	character:draft
character_get	Inspect a character and its references	studio:read
character_job_get	Inspect a Character workflow job	studio:read
character_job_recover	Recover retained Character job state	studio:write
character_list	Find saved characters	studio:read
character_media_preview	Play a saved Character audition or casting preview	studio:read
character_media_read	Read retained Character media	studio:read
character_reference_assign	Assign an inspected Character reference	studio:write
character_reference_generate	Generate missing Character views	studio:generate
character_reference_options_get	Inspect reference-role candidates	studio:read
character_setup_finish	Save Character setup completion	studio:write
character_video_generate	Generate one speaking-video candidate	studio:generate
character_voice_assign	Assign the inspected voice	studio:write
character_voice_autoselect	Choose a provisional Character voice	studio:write
character_voice_options_get	Find Character voice options	studio:read
character_voice_preview	Preview a voice option	studio:read
character_workflow_get	Inspect saved Character workflow state	studio:read

​

Locations

Tool	Purpose	Permission
location_draft_create	Save a Location draft	studio:write
location_job_get	Check an original Location job	studio:read
location_job_recover	Recover an original Location receipt	studio:write
location_reference_assign	Assign a saved Location image as an unapproved candidate	studio:write
location_reference_generate	Generate the next Location reference stage	studio:generate
location_reference_get	Inspect a Location reference	studio:read
location_reference_options_get	Read linked Location reference options	studio:read
location_workflow_get	Read a Location workflow	studio:read

​

Artifacts

Tool	Purpose	Permission
artifact_details_save	Save Artifact details	studio:write
artifact_draft_create	Save an Artifact draft	studio:write
artifact_image_generate	Create an Artifact design reference	studio:generate
artifact_image_preview	Inspect an Artifact image	studio:read
artifact_image_request_close	Close an unsent Artifact image preparation	studio:write
artifact_image_request_get	Read an original Artifact image request	studio:read
artifact_job_get	Read an original Artifact image job	studio:read
artifact_job_recover	Recover an original Artifact image job	studio:write
artifact_reference_select	Select an inspected Artifact reference	studio:write
artifact_workflow_get	Read an Artifact workflow	studio:read

​

Looks

Tool	Purpose	Permission
look_draft_create	Prepare a Character Look	studio:write
look_image_generate	Render a Character Look fit reference	studio:generate
look_image_preview	Inspect a Look fit image	studio:read
look_image_request_close	Close an unsent Look image preparation	studio:write
look_image_request_get	Read an original Look image request	studio:read
look_job_get	Read an original Look image job	studio:read
look_job_recover	Recover an original Look image job	studio:write
look_list_for_character	Find a Character’s saved Looks	studio:read
look_reference_select	Save an inspected Look version	studio:write
look_workflow_get	Read a Character Look	studio:read

​

References

Tool	Purpose	Permission
reference_image_list	Find saved reference images	studio:read
reference_image_preview	View a saved reference image	studio:read
reference_image_upload	Retain an incoming Studio reference	studio:write
reference_image_upload_get	Recover the original reference upload	studio:write
reference_image_upload_prepare	Prepare an attached reference image	studio:write

​

Productions

Tool	Purpose	Permission
production_assets_save	Pin the chosen Character and Location versions	production:write
production_cut_save	Assemble or edit the working cut	production:write
production_frames_generate	Generate the planned starting frames	production:generate
production_get	Read Production progress and the next step	production:read
production_job_get	Check the original Production operation	production:read
production_job_recover	Recover retained Production results without resubmission	production:write
production_media_preview	Inspect a Production frame or open its retained video	production:read
production_review_save	Record an inspection, draft selection or cut finding	production:write
production_scene_get	Read the source Scene before producing it	production:read
production_scene_save	Start a Production from a Scene	production:write
production_search	Find a Scene or Production	production:read
production_shots_plan	Ask Director AI to plan this Scene	production:generate
production_shots_save	Save the Director plan or a scoped shot correction	production:write
production_video_generate	Generate one take from the saved plan	production:generate
production_video_plan_save	Set performance direction or prepare a targeted retake	production:write