What your agent can do
The tools available over MCP — projects, script, cast, rendering, sound, and export.
Your agent discovers these itself, so you don't need to memorise them. This is here for when you want to know what's possible, or why something was refused.
Every tool takes a projectId, which is what lets one agent work across
several films at once.
Projects
| Tool | What it does |
|---|---|
listProjects | Every project in the workspace |
createProject | Start a new one |
duplicateProject | Copy a film — scenes, cast, settings, media links — so you can try a variation without risking the original |
updateProject | Title, premise, ending, style, synopsis |
deleteProject | Remove a project |
readProjectAssets | Everything the project can hand back, and what has actually finished rendering |
whatsNext | Where the project stands, what's blocked, what to do next |
Script and storyboard
Scenes are added, edited, removed and reordered; cast, locations and props are added and updated. A scene carries its visual action, its dialogue, and an intended duration — your agent writes all of it.
The script isn't a separate document. It's derived from the scenes, so an agent that writes the board has written the script.
Look and models
listGenerationModels returns every model with its price and what it's suited
to, which is what lets your agent recommend rather than guess.
setVisualStyle, setGenerationDefaults and setGenerationModel settle how
the film looks and what renders it.
Rendering
Renders happen in three waves, and the order is enforced rather than merely advised:
- References — character portraits and element plates.
- Frames — each scene's starting image. References attach automatically.
- Clips — animates a frame into video.
If your agent tries to skip ahead it gets told what to finish first. Renders
run in the background; checkGenerations reports progress.
Two things worth knowing, because they save credits:
- Reuse is free.
browseLibraryandsearchMediafind work you already have, and attaching it to a scene costs nothing. - Continuity is a feature, not a prompt. For a shot that picks up where another ends, the previous clip's final frame can be used directly as the reference — far more reliable than describing it.
Sound and export
Speech is synthesised from dialogue attributed to a character, using a voice you've assigned. Narration works the same way: a narrator is a voice-only cast member, and their lines are written onto the scenes they play over.
Once clips exist, the timeline is assembled and the film exported.
What isn't here
The free-form writing document and the in-app AI script generation stay in the browser. Both are Sundream's model writing on your behalf — which is the thing your own agent is there to do instead.