Use zzo.ai in Claude Code, Codex, Cursor and other local AI agents (MCP)
Connect zzo.ai to the AI agent on your computer and ask it to make videos and images. It uses the same credit balance and the same prices as the website: nothing extra per call, no subscription.
https://zzo.ai/api/mcpWhat it looks like
The assistant checks the price, asks you, then generates. The clip lands in your workspace too.

An example exchange. Wording varies by assistant; the tools and the price are real.
Connect in three steps
- 1
Create an API key
Open Settings → API Keys and create a key. Copy it right away; it starts with sk_.
Create a key - 2
Let your agent set it up
Copy the prompt below, put your key in place of sk_your_key and send it to your agent. Or copy the config for your app yourself.
- 3
Restart and ask
Restart the app if your agent says so, then ask, for example: "Make a 5-second 720p video of a lighthouse at dusk with zzo.ai. Tell me the price first."
Setup prompt for your agent
Works in Claude Code, Codex, Cursor, GitHub Copilot and other agents that can edit files on your computer. The agent writes the key to its own settings on your computer, never into a project.
Please add the zzo.ai MCP server to your settings, so you can make videos and images with zzo.ai for me. - Server URL: https://zzo.ai/api/mcp (remote MCP server, Streamable HTTP) - Header on every request: Authorization: Bearer sk_your_key - Server name: zzo 1. This only works in an agent running on my own computer. If you run in the cloud (a hosted chat or a cloud sandbox), don't change anything and tell me. 2. If the key above is still sk_your_key, ask me for my key first. 3. Add the server the way your app's documentation describes: its own command if it has one, otherwise its MCP config file. Keep the servers that are already there. 4. Use your user-level (global) settings, never a file inside a project folder, so the key can't end up in a git repository. Don't write the key anywhere else or show it to me again. 5. Tell me if I need to restart you. Once the zzo tools are available, call get_balance to check the connection (it uses no credits). Don't call generate unless I ask for it.
Or set it up yourself
Run this in a terminal. --scope user makes it available in every project and keeps the key out of your repositories.
claude mcp add --transport http --scope user zzo https://zzo.ai/api/mcp \ --header "Authorization: Bearer sk_your_key"
Other agents that run on your computer and can connect to a remote MCP server over Streamable HTTP with an Authorization header work the same way: use the server URL above and the header Authorization: Bearer sk_your_key.
Tools
Five tools. Only generate spends credits; the other four don't use any.
list_modelsModels you can use, their modes and options, and the starting price in credits.
No creditsestimate_costThe price of a generation in credits and dollars before you run it, and whether your balance covers it.
No creditsgenerateStarts a video or image generation and charges its credits. Returns a task id right away.
Spends creditsget_generationStatus and result links of a generation. The assistant checks about every 10 seconds until it is done.
No creditsget_balanceYour balance, what keys spent today and your daily limit.
No creditsLimits that protect your balance
An agent can loop. These limits stop it from spending more than you meant to:
- Each request costs at most 1,500 credits.
- Keys spend at most 3,000 credits a day (UTC) in total. You can lower this for your account.
- At most 5 generations run at the same time.
- Failed generations are refunded automatically, the same as on the website.
Questions
Does a generation cost more through MCP?
No. The price is the same as on the website, and it comes out of the same credit balance.
What happens when my balance runs out?
The generate tool returns an error with a link to the pricing page, and nothing is charged. Buy a credit pack and try again; credits never expire.
Can I animate my own image?
Yes, give the assistant a public https link to the image. Uploading files directly through MCP isn't supported yet.
What if my key leaks?
Delete it in Settings → API Keys; it stops working at once. The daily limit caps what any key can spend in the meantime.
Can I use it in ChatGPT, Claude.ai or a cloud agent?
Not yet. For now it works with AI agents running on your own computer, such as Claude Code, Codex, Cursor, GitHub Copilot in VS Code and Claude Desktop. ChatGPT, the Claude website and mobile apps, and agents that run in the cloud can't connect with an API key.