# 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-08-31

## 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 (404). 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 nothing since — young and 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.

## Verification

- Status: Freshly checked (checked today)
- Added: 2026-08-31
- Last verified: 2026-08-31
- 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