# JSON2Video MCP

> The vendor's own MCP: render JSON movies, validate them, and manage the media library.

- **Category:** Editing & Post
- **Vendor:** JSON2Video (official)
- **Pricing:** freemium
- **Verified:** 2026-10-13

## 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 Code: `claude mcp add json2video -e JSON2VIDEO_API_KEY=YOUR_KEY -- npx -y @json2video/cli mcp`
- Local: `npx -y @json2video/cli mcp`

**Auth:** api_key (env `JSON2VIDEO_API_KEY`) — <https://json2video.com>

## Capabilities

[cloud-render](https://mcp.film/capabilities/cloud-render.md) · [template-video](https://mcp.film/capabilities/template-video.md) · [captioning](https://mcp.film/capabilities/captioning.md) · [video-assembly](https://mcp.film/capabilities/video-assembly.md) · [tts](https://mcp.film/capabilities/tts.md) · [asset-management](https://mcp.film/capabilities/asset-management.md)

## Sample tools

`render_video` · `check_status` · `validate_movie` · `list_templates` · `get_template` · `get_example` · `get_account` · `media_list` · `media_upload` · `media_delete`

## Field 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.

## Alternatives

- [json2video MCP](https://mcp.film/mcps/json2video.md) — Superseded community wrapper — JSON2Video now ships its own MCP.
- [VibeFrame](https://mcp.film/mcps/vibeframe.md) — CLI-first video workflow runtime with an MCP surface for briefs-to-renders.
- [LeClap](https://mcp.film/mcps/leclap.md) — Deterministic video from one JSON template — same input, same frames, rendered locally.
- [OrkasVideoStudio](https://mcp.film/mcps/orkas-videostudio.md) — Local MCP and CLI toolkit for agent-driven video composition, editing, analysis, and rendering.
- [reap MCP](https://mcp.film/mcps/reap.md) — Hosted MCP that clips, captions, dubs, reframes, and publishes long-form footage.
- [Palmier Pro](https://mcp.film/mcps/palmier-pro.md) — AI-native Mac timeline editor with a built-in local MCP server — closed source since v0.7.6.

## Verification

- Status: Freshly checked (11 days old)
- Added: 2026-08-31
- Last verified: 2026-10-13
- Machine JSON: https://mcp.film/api/mcps/json2video-cli.json

## Links

- Site: https://json2video.com/?utm_source=mcp.film&utm_medium=referral&utm_campaign=directory&utm_content=json2video-cli%3Asite
- Docs: https://json2video.com/docs/v2/help-for-ai-agents/mcp-server?utm_source=mcp.film&utm_medium=referral&utm_campaign=directory&utm_content=json2video-cli%3Adocs

---

Structured data: https://mcp.film/api/mcps/json2video-cli.json · Directory: https://mcp.film
Canonical: https://mcp.film/mcps/json2video-cli/
Hosted directory MCP: https://mcp.film/mcp