> ## Documentation Index
> Fetch the complete documentation index at: https://docs.sia.vision/llms.txt
> Use this file to discover all available pages before exploring further.

# 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](https://docs.sia.vision/mcp-tools.json). It contains no account data or credentials.

## Library

| Tool | Purpose | Permission |
| - | - | - |
| [`library_search`](https://docs.sia.vision/tools/library_search) | Search saved Studio work | `studio:read` |
| [`library_status`](https://docs.sia.vision/tools/library_status) | Check the saved-work change watermark | `studio:read` |

## Storyworlds

| Tool | Purpose | Permission |
| - | - | - |
| [`storyworld_create`](https://docs.sia.vision/tools/storyworld_create) | Create a Storyworld | `studio:write` |
| [`storyworld_list`](https://docs.sia.vision/tools/storyworld_list) | Find your Storyworlds | `studio:read` |

## Characters

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

## Locations

| Tool | Purpose | Permission |
| - | - | - |
| [`location_draft_create`](https://docs.sia.vision/tools/location_draft_create) | Save a Location draft | `studio:write` |
| [`location_job_get`](https://docs.sia.vision/tools/location_job_get) | Check an original Location job | `studio:read` |
| [`location_job_recover`](https://docs.sia.vision/tools/location_job_recover) | Recover an original Location receipt | `studio:write` |
| [`location_reference_assign`](https://docs.sia.vision/tools/location_reference_assign) | Assign a saved Location image as an unapproved candidate | `studio:write` |
| [`location_reference_generate`](https://docs.sia.vision/tools/location_reference_generate) | Generate the next Location reference stage | `studio:generate` |
| [`location_reference_get`](https://docs.sia.vision/tools/location_reference_get) | Inspect a Location reference | `studio:read` |
| [`location_reference_options_get`](https://docs.sia.vision/tools/location_reference_options_get) | Read linked Location reference options | `studio:read` |
| [`location_workflow_get`](https://docs.sia.vision/tools/location_workflow_get) | Read a Location workflow | `studio:read` |

## Artifacts

| Tool | Purpose | Permission |
| - | - | - |
| [`artifact_details_save`](https://docs.sia.vision/tools/artifact_details_save) | Save Artifact details | `studio:write` |
| [`artifact_draft_create`](https://docs.sia.vision/tools/artifact_draft_create) | Save an Artifact draft | `studio:write` |
| [`artifact_image_generate`](https://docs.sia.vision/tools/artifact_image_generate) | Create an Artifact design reference | `studio:generate` |
| [`artifact_image_preview`](https://docs.sia.vision/tools/artifact_image_preview) | Inspect an Artifact image | `studio:read` |
| [`artifact_image_request_close`](https://docs.sia.vision/tools/artifact_image_request_close) | Close an unsent Artifact image preparation | `studio:write` |
| [`artifact_image_request_get`](https://docs.sia.vision/tools/artifact_image_request_get) | Read an original Artifact image request | `studio:read` |
| [`artifact_job_get`](https://docs.sia.vision/tools/artifact_job_get) | Read an original Artifact image job | `studio:read` |
| [`artifact_job_recover`](https://docs.sia.vision/tools/artifact_job_recover) | Recover an original Artifact image job | `studio:write` |
| [`artifact_reference_select`](https://docs.sia.vision/tools/artifact_reference_select) | Select an inspected Artifact reference | `studio:write` |
| [`artifact_workflow_get`](https://docs.sia.vision/tools/artifact_workflow_get) | Read an Artifact workflow | `studio:read` |

## Looks

| Tool | Purpose | Permission |
| - | - | - |
| [`look_draft_create`](https://docs.sia.vision/tools/look_draft_create) | Prepare a Character Look | `studio:write` |
| [`look_image_generate`](https://docs.sia.vision/tools/look_image_generate) | Render a Character Look fit reference | `studio:generate` |
| [`look_image_preview`](https://docs.sia.vision/tools/look_image_preview) | Inspect a Look fit image | `studio:read` |
| [`look_image_request_close`](https://docs.sia.vision/tools/look_image_request_close) | Close an unsent Look image preparation | `studio:write` |
| [`look_image_request_get`](https://docs.sia.vision/tools/look_image_request_get) | Read an original Look image request | `studio:read` |
| [`look_job_get`](https://docs.sia.vision/tools/look_job_get) | Read an original Look image job | `studio:read` |
| [`look_job_recover`](https://docs.sia.vision/tools/look_job_recover) | Recover an original Look image job | `studio:write` |
| [`look_list_for_character`](https://docs.sia.vision/tools/look_list_for_character) | Find a Character’s saved Looks | `studio:read` |
| [`look_reference_select`](https://docs.sia.vision/tools/look_reference_select) | Save an inspected Look version | `studio:write` |
| [`look_workflow_get`](https://docs.sia.vision/tools/look_workflow_get) | Read a Character Look | `studio:read` |

## References

| Tool | Purpose | Permission |
| - | - | - |
| [`reference_image_list`](https://docs.sia.vision/tools/reference_image_list) | Find saved reference images | `studio:read` |
| [`reference_image_preview`](https://docs.sia.vision/tools/reference_image_preview) | View a saved reference image | `studio:read` |
| [`reference_image_upload`](https://docs.sia.vision/tools/reference_image_upload) | Retain an incoming Studio reference | `studio:write` |
| [`reference_image_upload_get`](https://docs.sia.vision/tools/reference_image_upload_get) | Recover the original reference upload | `studio:write` |
| [`reference_image_upload_prepare`](https://docs.sia.vision/tools/reference_image_upload_prepare) | Prepare an attached reference image | `studio:write` |

## Productions

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


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.