mcp.film / Editing & Post / JSON2Video MCP
JSON2Video MCP
The vendor's own MCP: render JSON movies, validate them, and manage the media library.
What it does
JSON2Video's official MCP server, shipped as the `mcp` subcommand of its CLI. An agent describes a movie as JSON — scenes of video, images, text, HTML, voice-over and subtitles — validates it before spending credits, renders it server-side, then polls for the MP4. It also exposes the template catalogue and full media-library CRUD, which is what makes it usable for batch work: upload plates once, reference them across a hundred data-driven cuts without re-uploading.
Connect
claude mcp add json2video -e JSON2VIDEO_API_KEY=YOUR_KEY -- npx -y @json2video/cli mcp
{
"mcpServers": {
"json2video-cli": {
"command": "npx",
"args": [
"-y",
"@json2video/cli",
"mcp"
],
"env": {
"JSON2VIDEO_API_KEY": "YOUR_KEY_HERE"
}
}
}
}
{
"mcpServers": {
"json2video-cli": {
"command": "npx",
"args": [
"-y",
"@json2video/cli",
"mcp"
],
"env": {
"JSON2VIDEO_API_KEY": "YOUR_KEY_HERE"
}
}
}
}
JSON2VIDEO_API_KEY — https://json2video.com
Sample tools
render_videocheck_statusvalidate_movielist_templatesget_templateget_exampleget_accountmedia_listmedia_uploadmedia_deleteField notes
Do not run `npx @json2video/mcp` — JSON2Video's own marketing page tells you to, and that package does not exist on npm (still 404 on 13 Oct 2026). The working command is the CLI's subcommand, `npx -y @json2video/cli mcp`, which is what the actual MCP docs specify. The server is not open source: npm @json2video/cli is MIT-licensed but has no repository field and no public repo exists, so the thirteen tools listed in the docs are the only description of the surface you get. Two versions ever, 1.0.0 and 1.0.1 (Apr 14 2026), and still nothing newer six months on — quiet rather than proven, though the API behind it is mature and the vendor advertises 99.9% uptime. Node >=20, stdio only, no hosted endpoint. Needs outbound HTTPS to api.json2video.com and cdn.json2video.com, which matters in locked-down CI. Free tier is 600 credits (~10 minutes of render); paid starts around $50/month, so make the agent call validate_movie before render_video — a malformed movie that fails late still costs you. `json2video auth` writes credentials to ~/.config/json2video/config.json instead of the env var; pick one and stay with it.
Also in Editing & Post
Superseded community wrapper — JSON2Video now ships its own MCP.
CLI-first video workflow runtime with an MCP surface for briefs-to-renders.
Deterministic video from one JSON template — same input, same frames, rendered locally.
Local MCP and CLI toolkit for agent-driven video composition, editing, analysis, and rendering.
Hosted MCP that clips, captions, dubs, reframes, and publishes long-form footage.
AI-native Mac timeline editor with a built-in local MCP server — closed source since v0.7.6.
Pairs well with
Quoted dubbing, subtitles, transcription and multi-voice audiobooks from one remote MCP; a human approves each price.
Official Deepgram server: Nova transcription, diarization, and audio intelligence.
Official hosted Airtable MCP: query, create, and update production-tracking bases.