Bring your own agent
Connect an MCP client to create projects, edit scenes, and generate media in Sundream.
Model Context Protocol (MCP) lets an external AI agent call Sundream's project and generation tools. Changes it makes appear in the studio, and it can read work you've done in the browser.
Your agent uses its own model for writing and planning, billed by its provider. Media generated through Sundream uses your workspace's credits.
Choose a connection
| Connection | How it works |
|---|---|
| Local bridge | Run @sundream-studio/mcp on your computer. It connects your MCP client to Sundream and can save finished media to a local folder. |
| Remote server | Connect a client that supports remote MCP to the endpoint in Settings → API keys. Media tools return hosted URLs. |
The local bridge adds syncProjectMedia when you configure a media folder.
With a remote connection, you can download the returned URLs yourself.
Work on a film
The tools can create and duplicate projects, edit scenes and dialogue, manage cast and locations, choose models, generate media, assemble a timeline, and export a film.
Use listProjects to find project IDs. Tools that act on a film take a
projectId, so one connection can work on several projects.
See the tool guide for the generation order, activity history, and structured results.
Set a spending policy
Each key has a render-approval mode and an optional credit cap. In confirmation mode, a render returns a quote for the agent to approve. Auto-approval starts renders directly, subject to the key's cap and workspace limits.
For several renders, an agent can open a temporary credit budget with
approveSpend. See Keys and spending before
starting an unattended workflow.