JSON2Video

JSON2Video MCP Server

Official Model Context Protocol server for JSON2Video, the video API for automated video production at scale.

Connect your AI agent (Claude, Cursor, VS Code, Windsurf, Cline…) to JSON2Video and let it produce finished MP4 videos: build a video from reusable templates, add AI voiceovers, subtitles, AI-generated images and video, render it in the cloud and get back a URL you can publish.

Built and maintained by the JSON2Video team. The server ships inside the @json2video/cli npm package and runs locally over stdio.

Listed in the official MCP Registry as com.json2video/mcp.

What you can do

• "Make a 30-second vertical video about our new product with a voiceover and subtitles."
• "Render my Real estate listing template for each of these 10 properties."
• "Create a template for daily news shorts, then render today's three stories."
• "Upload this logo and add it as a watermark to the video."
• "How many credits do I have left?"

Requirements

• Node.js 20 or later
• A JSON2Video API key. Sign up for free and copy the key from the dashboard.

Installation

Claude Code (plugin)

Install the plugin from this repository. Claude Code asks for your API key and stores it securely:

/plugin install json2video --marketplace JSON2Video/json2video-mcp

On older Claude Code versions, run /plugin marketplace add JSON2Video/json2video-mcp first, then /plugin install json2video@json2video.

Claude Code (manual)

The quickest way, from your project folder:

npm install -g @json2video/cli
json2video auth --api-key YOUR_API_KEY
json2video mcp install claude

This adds the server to the project's .mcp.json and installs the create-video skill. Use cursor or vscode instead of claude for those editors. Or add it by hand:

claude mcp add json2video --env JSON2VIDEO_API_KEY=YOUR_API_KEY -- npx -y @json2video/cli mcp run

Claude Desktop, Cursor, Windsurf and other clients

Add this to your client's MCP configuration file (claude_desktop_config.json, ~/.cursor/mcp.json, ~/.codeium/windsurf/mcp_config.json…):

{
  "mcpServers": {
    "json2video": {
      "command": "npx",
      "args": ["-y", "@json2video/cli", "mcp", "run"],
      "env": {
        "JSON2VIDEO_API_KEY": "YOUR_API_KEY"
      }
    }
  }
}

VS Code

Add this to .vscode/mcp.json:

{
  "servers": {
    "json2video": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@json2video/cli", "mcp", "run"],
      "env": {
        "JSON2VIDEO_API_KEY": "YOUR_API_KEY"
      }
    }
  }
}

Restart your client after saving. Full instructions for every editor: MCP server documentation.

Tools

What runs on your machine

The plugin and the configs above run npx -y @json2video/cli mcp run. npx downloads the published @json2video/cli package from npm and starts the MCP server locally over stdio. The server sends your requests (movie JSON, template variables, media files you choose to upload) to the JSON2Video API at api.json2video.com, authenticated with your API key. To answer help and example requests it also downloads public reference files (documentation, examples, voice and music lists) from cdn.json2video.com and JSON2Video's public S3 buckets. It sends no data to any other service.

Configuration

Renders use the credits of your JSON2Video account. Free accounts include credits to try it out; see pricing.

Resources

• JSON2Video
• Documentation
• MCP server guide
• Video editing with Claude Code
• @json2video/cli on npm
• Support: the chat on json2video.com

License

MIT