MCP setup

Getting Started with Squall Studio MCP

Connect an MCP client to your Squall Studio account with a bearer API key. The server speaks Streamable HTTP at https://squallstudio.com/api/mcp.

1. Create an API Key

Open the API keys page in Squall Studio, create a key for your MCP client, and copy it when it is shown. The token is only displayed once.

Open API keys

2. Choose Scopes

Read projects

projects:read - Read owned projects, scripts, episodes, shots, characters, locations, assets, and jobs.

Edit scripts

script:write - Patch authored shot and location fields in place. These edits do not spend credits.

Generate media

generation:write - Start image, video, and music generation jobs that spend the same credits as the web app.

3. Connect a Client

Configure a Streamable HTTP MCP connection with the endpoint and authorization header below. Replace the placeholder with your own Squall Studio API key.

Endpoint

https://squallstudio.com/api/mcp

Header

Authorization: Bearer YOUR_SQUALL_API_KEY

claude mcp add --transport http squall-studio \
  https://squallstudio.com/api/mcp \
  --header "Authorization: Bearer YOUR_SQUALL_API_KEY"

4. Verify the Connection

Ask the client to list your Squall Studio projects. With a key that includes projects:read, it should be able to call list_projects and return only projects owned by the key's account.

The current server exposes 25 tools: read tools for project state, edit tools for shots and locations, and generation tools that return job ids.

Tool Reference Workflow Examples