Ziztu MCP tools
The Ziztu MCP server has 30 tools. Here they are grouped by what they do, in the order an agent uses them, each with its arguments.
For AI agents: the documentation index is at /llms.txt, and every page here has a markdown version at the same address with .md added.
Updated
How an agent uses them
- Create a project, then send the idea to the Director with
director_chat. - Apply the free actions of its reply with
apply_plan. - Price the next step with
quote. A shot that is blocked is listed with the reason. - Make first frames, then clips, then music, each with
max_credits. - Follow the jobs with
job_status, thenexport_film.
Every tool that costs credits takes max_credits, asks for confirm above 5,000 credits and accepts dry_run. To connect a client, see the MCP server page. One resource is available too: project://{project_id} returns the full project JSON.
Projects
Make and read projects. Reading is free.
| Tool | What it does | Arguments |
|---|---|---|
list_projects | List the projects of the account with counts and IDs; use get_project for the details | None |
create_project | Create a new empty film project, free | { name, aspect? } |
get_project | Read one project with its shots, cast, music and exports, free | { project_id, full? } |
Plan with the Director
The Director plans the cast, the places and every shot. apply_plan applies the free actions.
| Tool | What it does | Arguments |
|---|---|---|
director_chat | Ask the Director in plain words to plan or change the film; the reply id goes to apply_plan | { project_id, message } |
director_plan | Preview a scene plan for a story idea without saving anything, so build with director_chat instead | { project_id, text } |
apply_plan | Apply the free actions of a Director reply, which adds the cast, places, shots and music, safe to repeat | { project_id, message_id } |
Price
Ask the exact price and read the balance. Neither starts anything.
| Tool | What it does | Arguments |
|---|---|---|
quote | Price frames, animate or music exactly, without spending | { project_id, operation, shot_ids?, track_ids?, count? } |
get_credits | Get the credit balance and plan | None |
Make
Each needs max_credits, asks for confirm above the threshold and accepts dry_run.
| Tool | What it does | Arguments |
|---|---|---|
make_first_frames | Spends credits to make the still image of each shot, before animate_shots | { project_id, max_credits, shot_ids?, count?, model?, confirm?, skip_blocked?, dry_run? } |
animate_shots | Spends credits to make the video clip of each shot, after make_first_frames | { project_id, max_credits, shot_ids?, confirm?, skip_blocked?, dry_run? } |
make_music | Spends credits to make the audio of the planned music tracks | { project_id, max_credits, track_ids?, confirm?, dry_run? } |
Export and follow jobs
Build the finished film and follow what is running.
| Tool | What it does | Arguments |
|---|---|---|
export_film | Render the timeline to one MP4, free, returns a job to follow with job_status | { project_id } |
job_status | Check one background job until final is true | { job_id } |
list_jobs | List all jobs of a project | { project_id } |
Studio apps
Run the Studio apps (animation, manga, story video, explainer, comedy skit) the same way.
| Tool | What it does | Arguments |
|---|---|---|
list_tools | List the one-shot Studio apps that run_tool can start | None |
recommend_tool | Recommend the best Studio app for an idea | { query } |
run_tool | Spends credits to start a one-shot Studio app from a prompt, use dry_run first | { tool, prompt, max_credits, settings?, confirm?, dry_run?, project_id?, title?, inputs? } |
get_tool_run | Get the status, gates and outputs of a run_tool run | { tool, project_id } |
approve_tool_run | Spends credits by raising the cap of a paused run_tool run | { tool, project_id, max_credits, confirm? } |
Scripts
The whole AI Script Writer as tools. They read and write text only.
| Tool | What it does | Arguments |
|---|---|---|
start_script_draft | Spends credits to write a screenplay draft from an idea (story plan, scenes, editor's pass) as a job; price it with dry_run and follow it with get_script_job | { idea?, format?, project_id?, name?, aspect?, plan_only?, plan_job_id?, story_plan?, replace_existing?, max_credits, confirm?, dry_run? } |
get_script_job | Check a script job: its steps, the story plan and the result, free | { project_id, job_id, wait_seconds? } |
read_script | Read the outline and the Fountain text of the script, free | { project_id, scenes?, include_text?, max_chars? } |
ask_script_editor | Spends credits to ask the script editor a question or for a change; it proposes edits and changes nothing | { project_id, message, scene?, scope?, max_credits, confirm?, dry_run? } |
decide_script_edit | Apply or reject the proposed edits by id, with a version saved first, free | { project_id, message_id, decision, edit_ids? } |
get_script_doctor_notes | Spends credits for the AI Script Doctor's notes on a scene or the whole draft; it changes nothing | { project_id, scope?, scene?, lens?, focus?, max_credits, confirm?, dry_run? } |
list_script_versions | List the saved versions, or compare one with another or with now, free | { project_id, compare?, to? } |
restore_script_version | Bring a version back; the current script is saved first, free | { project_id, version_id } |
import_script | Put Fountain, Final Draft or plain text into a project, free | { text, project_id?, name?, format?, mode?, replace_existing?, aspect? } |
get_script_file | Get the script as Fountain text, or a ten minute link to a PDF or Final Draft file, free | { project_id, format, title_page? } |
script_to_shots | Spends credits to plan the shots, cast and places of scenes as a proposal for apply_plan, without making any picture, clip or sound | { project_id, scenes?, max_credits, confirm?, dry_run? } |
The planner edition has fewer tools
The planner edition at https://getziztu.com/mcp/planner has 24 tools and none that makes images, video or audio. See Ziztu Planner.
Other ways to use Ziztu
- The Ziztu Chrome extension turns any text you select on a web page into a micro drama or anime scene. Its privacy policy says what it collects: nothing.
- Ziztu for Notion sends a Reel Factory plan to a Notion board and updates each row when the reel is made.
- The connectors add Ziztu to Claude, ChatGPT, Codex, Cursor and Grok.
Frequently asked questions
How many tools does the Ziztu MCP server have?
The Ziztu MCP server has 30 tools. They plan, price, make and export episodes, run the Studio apps and write scripts.
Which tool makes video?
animate_shots makes the clips, after make_first_frames makes the still of each shot. Both take max_credits, and dry_run returns the price first.
Can I see the price before a tool spends credits?
Yes. Call quote, or add dry_run to a paid tool. Nothing is started.
Which tool starts a conversation with the Director?
director_chat. The reply has an id and a list of proposed actions, and apply_plan applies the free ones.
More docs
- Ziztu APIThe Ziztu API is a REST API at https://getziztu.com/api/v1.
- Ziztu credits and spend capsEverything on Ziztu is paid in credits. The price of a result is known before it starts, and every paid API or MCP call carries a…
- Ziztu API errors and rate limitsThe Ziztu API answers every failure with a JSON error that has a code you can switch on and a message you can show.
- Ziztu PlannerZiztu Planner brings the Script Writer and the Director into Claude and other MCP clients.
- Ziztu YouTube StudioZiztu YouTube Studio is an MCP server at https://getziztu.com/mcp/youtube.
- Ziztu OpenAPI specThe Ziztu API is described as one OpenAPI 3.1 document at https://getziztu.com/openapi.json.
- Ziztu API quickstartZiztu has a REST API.
- Ziztu skills for agentsZiztu publishes two skills for AI agents under the MIT license: one writes micro drama series and episodes, the other writes…
Also on Ziztu
- Ziztu Story ReelsAnimated story reels made with Claude: couples, family, comebacks and twists, with your product inside the story.
- Ziztu changelog, 10 October 2026The Ziztu name, the blog and 94 pages with real examples.
Connect your agent and run the first plan.
Start for $10 a month. Ziztu starts at $10 a month for 7,000 credits.