Zvid — Claude Code MCP server for video and images
Zvid connects an agent to tools for building videos and images from JSON projects. Use it to validate a draft before approving a render.
claude mcp add --transport http mcp https://mcp.zvid.io/mcpWhat Zvid does
The MCP server helps an agent plan a project, find assets, assemble its JSON payload, and check for errors or layout warnings. Once the project passes validation, the agent can save a draft. Creating media does not spend credits; rendering requires a user-approved signed quote.
Projects can also become reusable templates with variables and safe default values. The Creator profile rejects create_media and revise_media requests without a complete payload, so a brief alone is not enough to create media. Connect to the hosted service with OAuth or an API key. Local stdio requires an API key and Node.js 18 or later.
What it helps with
- build a video or image from a JSON project
- validate a layout and fix warnings before saving a draft
- turn a project into a reusable parameterized template
- request a render after approving its signed quote
Example prompts for the agent
- Build a video from this JSON project, validate it, and save a draft for review.
- Prepare an image project and fix any validation errors or layout warnings before saving.
- Save this project as a template with variables, then render it after I approve the quote.
How to install Zvid
1Platform CLI: remote server
claude mcp add --transport http mcp https://mcp.zvid.io/mcp2Platform CLI
claude mcp add --env ZVID_API_KEY=<ZVID_API_KEY> --env ZVID_API_URL=<ZVID_API_URL> --transport stdio zvid -- npx -y @zvid/mcpReplace <…> with your own values
1Platform CLI: remote server
codex mcp add zvid --url https://mcp.zvid.io/mcp2Platform CLI
codex mcp add zvid --env ZVID_API_KEY=<ZVID_API_KEY> --env ZVID_API_URL=<ZVID_API_URL> -- npx -y @zvid/mcpReplace <…> with your own values
Config file
{
"mcpServers": {
"zvid": {
"url": "https://mcp.zvid.io/mcp"
}
}
}{
"mcpServers": {
"zvid": {
"command": "npx",
"args": [
"-y",
"@zvid/mcp"
],
"env": {
"ZVID_API_KEY": "<ZVID_API_KEY>",
"ZVID_API_URL": "<ZVID_API_URL>"
}
}
}
}Replace <…> with your own values
Config file
{
"servers": {
"zvid": {
"type": "http",
"url": "https://mcp.zvid.io/mcp"
}
}
}{
"servers": {
"zvid": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@zvid/mcp"
],
"env": {
"ZVID_API_KEY": "<ZVID_API_KEY>",
"ZVID_API_URL": "<ZVID_API_URL>"
}
}
}
}Replace <…> with your own values
1Platform CLI: remote server
gemini mcp add -t http zvid https://mcp.zvid.io/mcp2Platform CLI
gemini mcp add -e ZVID_API_KEY=<ZVID_API_KEY> -e ZVID_API_URL=<ZVID_API_URL> zvid npx -y @zvid/mcpReplace <…> with your own values
Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about Zvid
How do I install Zvid in Claude Code?
Add the hosted server with claude mcp add --transport http mcp https://mcp.zvid.io/mcp. Then sign in through MCP in Claude Code.
What does Zvid do?
It gives an agent tools to prepare and validate JSON projects for video and image creation, save drafts, and create reusable templates.
Does Zvid require an API key?
The hosted service supports OAuth sign-in with a Zvid account or an API key. Local stdio uses an API key and requires Node.js 18 or later.
