ziztu
Make a video

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

  1. Create a project, then send the idea to the Director with director_chat.
  2. Apply the free actions of its reply with apply_plan.
  3. Price the next step with quote. A shot that is blocked is listed with the reason.
  4. Make first frames, then clips, then music, each with max_credits.
  5. Follow the jobs with job_status, then export_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.

ToolWhat it doesArguments
list_projectsList the projects of the account with counts and IDs; use get_project for the detailsNone
create_projectCreate a new empty film project, free{ name, aspect? }
get_projectRead 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.

ToolWhat it doesArguments
director_chatAsk the Director in plain words to plan or change the film; the reply id goes to apply_plan{ project_id, message }
director_planPreview a scene plan for a story idea without saving anything, so build with director_chat instead{ project_id, text }
apply_planApply 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.

ToolWhat it doesArguments
quotePrice frames, animate or music exactly, without spending{ project_id, operation, shot_ids?, track_ids?, count? }
get_creditsGet the credit balance and planNone

Make

Each needs max_credits, asks for confirm above the threshold and accepts dry_run.

ToolWhat it doesArguments
make_first_framesSpends 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_shotsSpends 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_musicSpends 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.

ToolWhat it doesArguments
export_filmRender the timeline to one MP4, free, returns a job to follow with job_status{ project_id }
job_statusCheck one background job until final is true{ job_id }
list_jobsList all jobs of a project{ project_id }

Studio apps

Run the Studio apps (animation, manga, story video, explainer, comedy skit) the same way.

ToolWhat it doesArguments
list_toolsList the one-shot Studio apps that run_tool can startNone
recommend_toolRecommend the best Studio app for an idea{ query }
run_toolSpends 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_runGet the status, gates and outputs of a run_tool run{ tool, project_id }
approve_tool_runSpends 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.

ToolWhat it doesArguments
start_script_draftSpends 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_jobCheck a script job: its steps, the story plan and the result, free{ project_id, job_id, wait_seconds? }
read_scriptRead the outline and the Fountain text of the script, free{ project_id, scenes?, include_text?, max_chars? }
ask_script_editorSpends 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_editApply or reject the proposed edits by id, with a version saved first, free{ project_id, message_id, decision, edit_ids? }
get_script_doctor_notesSpends 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_versionsList the saved versions, or compare one with another or with now, free{ project_id, compare?, to? }
restore_script_versionBring a version back; the current script is saved first, free{ project_id, version_id }
import_scriptPut Fountain, Final Draft or plain text into a project, free{ text, project_id?, name?, format?, mode?, replace_existing?, aspect? }
get_script_fileGet 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_shotsSpends 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.

  • 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

See all: Docs · Site map

Connect your agent and run the first plan.

Start for $10 a month. Ziztu starts at $10 a month for 7,000 credits.

Video
Image
Audio
Writing
Effects
Learn
PricingLog in
Theme