JSON2Video MCP server

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 (claudedesktopconfig.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

Shortened. The full README is on GitHub.