JSON2Video — Claude Code MCP server: video and setup
Connect an agent to JSON2Video to render videos from movie JSON or templates and receive a video URL. Useful when you want to prepare video projects through an AI coding client.
claude mcp add mcp -e JSON2VIDEO_API_KEY=<JSON2VIDEO_API_KEY> -- npx -y @json2video/cliWhat JSON2Video does
The server lets an agent inspect movie JSON before rendering, browse account templates, fill template variables, and submit a render. It can also save reusable templates, manage media files, and retrieve account credit details. Rendered videos come back as URLs.
It runs locally through npx -y @json2video/cli and sends requests to the JSON2Video API. You need Node.js 20 or later and a JSON2VIDEO_API_KEY; renders spend credits from your account, so projects cannot be submitted without a key. In Claude Code, the setup command registers the server over stdio.
What it helps with
- render a video from movie JSON and retrieve its URL
- fill a template with project-specific variables
- validate movie JSON before rendering
- upload media to the account library
- check remaining account credits
Example prompts for the agent
- Create a video from this brief and return the finished video's URL.
- Show my templates and render the selected one with these variables.
- Validate this movie JSON and check the account's remaining credits.
How to install JSON2Video
Platform CLI
claude mcp add mcp -e JSON2VIDEO_API_KEY=<JSON2VIDEO_API_KEY> -- npx -y @json2video/cliReplace <…> with your own values
Platform CLI
codex mcp add json2video --env JSON2VIDEO_API_KEY=<JSON2VIDEO_API_KEY> -- npx -y @json2video/cliReplace <…> with your own values
Config file
{
"mcpServers": {
"json2video": {
"command": "npx",
"args": [
"-y",
"@json2video/cli"
],
"env": {
"JSON2VIDEO_API_KEY": "<JSON2VIDEO_API_KEY>"
}
}
}
}Replace <…> with your own values
Config file
{
"servers": {
"json2video": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@json2video/cli"
],
"env": {
"JSON2VIDEO_API_KEY": "<JSON2VIDEO_API_KEY>"
}
}
}
}Replace <…> with your own values
Platform CLI
gemini mcp add -e JSON2VIDEO_API_KEY=<JSON2VIDEO_API_KEY> json2video npx -y @json2video/cliReplace <…> 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 JSON2Video
How do I install JSON2Video in Claude Code?
Run claude mcp add mcp -e JSON2VIDEO_API_KEY=<JSON2VIDEO_API_KEY> -- npx -y @json2video/cli. Replace the placeholder with your API key.
What does JSON2Video do?
It gives an agent tools to validate video JSON, work with templates and media, and request video renders through JSON2Video. The render response includes a video URL.
What do I need to run the server?
Install Node.js 20 or later and provide a JSON2Video API key. Rendering uses credits from your account.
