json2video MCP Server

A Model Context Protocol (MCP) server implementation for programmatically generating videos using the json2video API. This server exposes powerful video generation and status-checking tools for use with LLMs, agents, or any MCP-compatible client.

Features

• Generate videos with rich scene and element support (text, image, video, audio, components, subtitles, etc.)
• Asynchronous video rendering with status polling
• Flexible, extensible JSON schema for video projects
• Designed for easy integration with LLMs, automation agents, and MCP-compatible tools
• API key authentication (env or per-request)
• Comprehensive error handling and logging

Installation# Running with npx

env JSON2VIDEO_API_KEY=your_api_key_here npx -y @omerrgocmen/json2video-mcp
```\n\n### Manual Installation
```bash
npm install -g @omerrgocmen/json2video-mcp
```\n\n### Windows Users
If you are on Windows and encounter issues, try:
```bash
cmd /c "set JSON2VIDEO_API_KEY=your_api_key_here && npx -y @omerrgocmen/json2video-mcp"

Running on Cursor# Cursor v0.48.6+

1. Open Cursor Settings
2. Go to Features > MCP Servers
3. Click "+ Add New MCP Server"
4. Enter the following:

• Name: "json2video-mcp" (or your preferred name)
• Type: "command"
• Command: env JSON2VIDEO_API_KEY=your_api_key_here npx -y @omerrgocmen/json2video-mcp

MCP Integration Example

Add this to your mcp.json or similar config:

{
  "mcpServers": {
    "json2video-mcp": {
      "command": "npx",
      "args": ["-y", "@omerrgocmen/json2video-mcp"],
      "env": {"JSON2VIDEO_API_KEY": "your_api_key_here"}
    }
  }
}

Usage# Available Tools\n\n#### 1. Generate Video (generate_video)

Creates a customizable video project with scenes and elements.

2. Get Video Status (get_video_status)

Check the status or retrieve the result of a video generation job.

3. Create Template (create_template)

Create a new template in json2video.

4. Get Template (get_template)

Get template details from json2video.

5. List Templates (list_templates)

List all available templates from json2video.