Use Ziztu from an AI agent

You need an API key first.

1. Open the Studio at getziztu.com/app and sign in. Open Settings, then API keys.
2. Name the key (for example "Claude Code") and pick its scopes: read to look around, generate to plan and make things, export to download films.
3. Copy the key. It starts with sk_sakuga_ and is shown once.

Then add the server to Claude Code. Put your key where it says sk_sakuga_your_key.

claude mcp add -e ZIZTU_TOKEN=sk_sakuga_your_key ziztu -- npx -y https://getziztu.com/dl/ziztu-mcp.tgz

The line runs the Ziztu MCP server from https://getziztu.com/dl/ziztu-mcp.tgz. It needs Node 20 or newer. Using Claude Desktop or Cursor? The MCP server page has the JSON for each.

Paste this into the agent. It plans an episode and prices it, and stops before anything is generated.

Use Ziztu to plan a 60 second vertical micro drama about a baker who finds a love letter in the dough. Create the project, ask the Director to plan it, apply the plan, then quote the first frames. Do not generate anything yet. Tell me the price and which shots are blocked.

The agent will call create_project, director_chat, apply_plan, quote in that order:

• create_project makes an empty project (9:16 for a vertical drama).
• director_chat sends your idea to the Director. The reply has an id and a list of proposed actions: the cast, the places and each shot.
• apply_plan applies the free actions from that reply, so the project now has its characters and shots.
• quote returns the exact credits for the first frames and lists every shot that is blocked, with the reason.

No first frame or clip is made, because those tools need max_credits and you have not given one. Director messages are metered by use and come off your credit balance.

When the quote looks right, tell the agent to go ahead with a cap.

Make the first frames for that project with max_credits 200. When they are done, show me the frames and wait. I will tell you whether to animate the shots.

The order the agent follows from here:

1. make_first_frames with max_credits. The still image of each shot comes first, so you can check the cast before you pay for motion.
2. job_status until the jobs finish.
3. animate_shots with max_credits. Add confirm: true only if you really mean to spend more than 500 credits.
4. make_music if you want a score, then export_film to build the finished video.

If quote says a shot is blocked, the reason tells you what is missing. Ask the Director to fix it with director_chat, or edit the shot in the Studio, then quote again.

These are enforced by the server, not by the agent, so a confused or careless agent still cannot spend past the cap.

• max_credits is required on every call that costs credits: first frames, clips, music and Studio app runs. If the price is higher, the call is refused before anything starts.
• Above 500 credits, add confirm: true. A bigger spend needs a second, explicit yes.
• Ask the price first. dry_run: true or the quote tool returns the exact credits and starts nothing. The quote also lists any shot that is blocked, and why.
• Retries are safe with an Idempotency-Key header: the same key and body returns the first answer instead of running twice.
• Scope the key. A key without generate cannot start paid work. Make a read key for an agent that should only look.
• Revoke it any time under Settings, API keys. It stops working at once.

Rate limits: 120 requests a minute per key, and 30 paid requests a minute.

Claude Desktop and Cursor take the same server as JSON.

{
  "mcpServers": {
    "ziztu": {
      "command": "npx",
      "args": [
        "-y",
        "https://getziztu.com/dl/ziztu-mcp.tgz"
      ],
      "env": {
        "ZIZTU_TOKEN": "sk_sakuga_your_key"
      }
    }
  }
}

{
  "mcpServers": {
    "ziztu": {
      "command": "npx",
      "args": [
        "-y",
        "https://getziztu.com/dl/ziztu-mcp.tgz"
      ],
      "env": {
        "ZIZTU_TOKEN": "sk_sakuga_your_key"
      }
    }
  }
}

Any other MCP client that starts a stdio server works with the command npx -y https://getziztu.com/dl/ziztu-mcp.tgz and the ZIZTU_TOKEN variable. The MCP server page lists every tool.

The MCP server is a thin layer over the REST API, so anything it does you can do with curl. This checks your key and balance:

curl -s https://getziztu.com/api/v1/credits -H "Authorization: Bearer $ZIZTU_TOKEN"

The API page has a full session from a new project to an export.