JSON2Video

Video API for automated video production at scale: templates, AI voiceovers, subtitles, AI images

What can you do with JSON2Video?

"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?"

Install

Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).

NPM package @json2video/cli

Claude Code

claude mcp add json2video -e 'JSON2VIDEO_API_KEY=<your json2video_api_key>' -- npx -y @json2video/cli@1.1.4 mcp run

JSON configuration (Claude Desktop, Cursor, VS Code)

{
    "mcpServers": {
        "json2video": {
            "command": "npx",
            "args": [
                "-y",
                "@json2video/cli@1.1.4",
                "mcp",
                "run"
            ],
            "env": {
                "JSON2VIDEO_API_KEY": "<your json2video_api_key>"
            }
        }
    }
}

Environment variables

JSON2VIDEO_API_KEY required secret Your JSON2Video API key (get one at https://json2video.com/dashboard)

Documentation

From the project's README on GitHub, refreshed weekly. Links open on GitHub.

Contents

JSON2Video MCP Server
What you can do
Requirements
Installation
Tools
What runs on your machine
Configuration
Resources
License

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

Tool	What it does
`render_video`	Render a video from a movie JSON or from a template with variables. Returns the video URL.
`check_status`	Check the rendering status of a video project.
`validate_movie`	Validate a movie JSON without rendering it.
`list_templates`	List the templates in your account.
`list_featured_templates`	List the templates in the public template library.
`get_template`	Get a template's variables or its full source.
`save_template`	Save a movie JSON as a reusable template.
`get_example`	Get an example movie JSON.
`get_help`	Get help on the movie JSON syntax, elements and transitions.
`get_account`	Get account information and remaining credits.
`media_list`	List files in your media storage.
`media_get`	Get a file's details and download URL.
`media_upload`	Upload a file from a local path or a public URL.
`media_delete`	Delete a file from your media storage.

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

Environment variable	Required	Description
`JSON2VIDEO_API_KEY`	Yes	Your JSON2Video API key.
`JSON2VIDEO_TIMEOUT`	No	Maximum time to wait for a render, in seconds (default 240).

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

Resources

License

MIT

Frequently asked questions

What is JSON2Video?

Video API for automated video production at scale: templates, AI voiceovers, subtitles, AI images

How do I install JSON2Video?

It runs on your machine. In Claude Code: claude mcp add json2video -e 'JSON2VIDEO_API_KEY=<your json2video_api_key>' -- npx -y @json2video/cli@1.1.4 mcp run. For other clients, paste the JSON configuration from this page into their MCP settings.

Does JSON2Video need an API key?

Yes. It expects JSON2VIDEO_API_KEY, which you set in its configuration.

Is JSON2Video open source?

Yes. Its code is on GitHub under the MIT license.

Who maintains JSON2Video?

It is published by JSON2Video. AI.tn lists it but does not maintain or endorse it.

From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.

Server details

Listed in: Official MCP Registry
Publisher: JSON2Video
Category: Media and design
Runs: Local
GitHub stars: ★ 0
License: MIT
Last commit: Oct 23, 2026
Open issues: 0
Version: 1.1.4
Published: Oct 23, 2026

com.json2video/mcp

Similar servers

RedNote Trending (小红书): Viral Notes, Full Text & Likes RedNote (Xiaohongshu 小红书) trending notes, no login: full text, images, video, tags, ...
AISTLabs Video, image and audio generation on top AI models for agents, with an AI director buil...
PCBEditor Design, route, check, review and export manufacturable PCBs from plain language; KiCad ...
MP4.now MCP Server Convert MP4 video with MP3, WebM, MOV, AVI, GIF, WAV, JPG and MKV workflows.
JPG.now MCP Server Convert JPG images to and from popular formats through MCP-compatible AI clients.
CHRP EPI Authority Music-listening Emotional Performance Intelligence: definitions, states, guidance and M...
SpicyAPI MCP Image, video and audio generation APIs with USD quotes and confirmation before paid req...
Image Tools Resize, compress, convert, crop, rotate and watermark images, one at a time or in a zip.

Media and design