How do I use json2video MCP Server?

1. Click on "Deploy Server". 2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state. 3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@json2video MCP Server Create a short promotional video with text overlay" That's it! The server will respond to your query, and you can continue using it as needed. Here is a step-by-step guide with screenshots.

json2video MCP Server

by omergocmen

Overview Schema Source Related Servers Discussions Admin

JavaScript

Remote

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

Related MCP server: Agnes Video MCP Server

Installation

Running with npx

env JSON2VIDEO_API_KEY=your_api_key_here npx -y @omerrgocmen/json2video-mcp

Manual Installation

npm install -g @omerrgocmen/json2video-mcp

Windows Users

If you are on Windows and encounter issues, try:

cmd /c "set JSON2VIDEO_API_KEY=your_api_key_here && npx -y @omerrgocmen/json2video-mcp"

Running on Cursor

Cursor v0.48.6+

Open Cursor Settings
Go to Features > MCP Servers
Click "+ Add New MCP Server"
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

Cursor v0.48.6+

Open Cursor Settings
Go to Features > MCP Servers
Click "+ Add new global MCP server"

Enter the following code:

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

Replace your_api_key_here with your json2video API key. You can get an API key from json2video.com.

After adding, refresh the MCP server list to see the new tools. Your agent or LLM will automatically use json2video MCP when appropriate, or you can explicitly request it by describing your video generation needs.

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

Replace your_api_key_here with your actual json2video API key.
This configuration allows your agent or LLM to start and communicate with the json2video MCP server automatically.
The server will expose the generate_video and get_video_status tools for use in your workflows.

Configuration

Environment Variables

JSON2VIDEO_API_KEY (required): Your json2video API key. Can be set as an environment variable or provided per request.

Note: If you encounter a client closed error, run the following command in your terminal:
npm i @omerrgocmen/json2video-mcp

Usage

Available Tools

1. Generate Video (`generate_video`)

Create a customizable video project with scenes and elements.

Description: Creates a video project using the json2video API. Each project can contain multiple scenes, and each scene can contain various elements such as text, images, video, audio, components, HTML, voice, audiogram, and subtitles. Video generation is asynchronous; use the returned project ID to check status. See https://json2video.com/docs/api/ for full schema and more examples.

Input Schema:

{
  "id": "string (optional, unique identifier for the movie)",
  "comment": "string (optional, project description)",
  "cache": true,
  "client_data": {},
  "draft": true,
  "quality": "high", // one of: low, medium, high
  "resolution": "custom", // one of: sd, hd, full-hd, squared, instagram-story, instagram-feed, twitter-landscape, twitter-portrait, custom
  "width": 1920, // required if resolution is custom
  "height": 1080, // required if resolution is custom
  "variables": {},
  "elements": [ /* global elements, see below for examples */ ],
  "scenes": [
    {
      "id": "string (optional, unique scene id)",
      "comment": "string (optional)",
      "background_color": "#000000",
      "cache": true,
      "condition": "string (optional)",
      "duration": -1,
      "variables": {},
      "elements": [ /* see element examples below */ ]
    }
  ],
  "apiKey": "string (optional)"
}

Element Types & Examples:

Text Element:

{
  "type": "text",
  "text": "Hello world",
  "duration": 5,
  "settings": { "font-size": "60px", "color": "#FF0000" }
}

Image Element:

{
  "type": "image",
  "src": "https://images.pexels.com/photos/1105666/pexels-photo-1105666.jpeg",
  "width": 1620,
  "height": 1080,
  "x": 0,
  "y": 0
}

Video Element:

{
  "type": "video",
  "src": "https://example.com/path/to/my/video.mp4",
  "duration": 7.3
}

Component Element:

{
  "type": "component",
  "component": "basic/001",
  "settings": {
    "headline": { "text": "Lorem ipsum", "color": "white" },
    "body": { "text": "Dolor sit amet" }
  }
}

HTML Element:

{
  "type": "html",
  "html": "<h1>Hello world</h1>",
  "width": 800,
  "height": 600
}

Audio Element:

{
  "type": "audio",
  "src": "https://example.com/audio.mp3",
  "duration": 5
}

Voice Element:

{
  "type": "voice",
  "text": "This is a voiceover.",
  "voice": "en-US-Wavenet-D"
}

Audiogram Element:

{
  "type": "audiogram",
  "color": "#00FF00",
  "amplitude": 5
}

Subtitles Element:

{
  "type": "subtitles",
  "captions": "1\n00:00:00,000 --> 00:00:02,000\nHello world!"
}

Example Input:

{
  "comment": "MyProject",
  "resolution": "full-hd",
  "scenes": [
    {
      "elements": [
        { "type": "video", "src": "https://example.com/path/to/my/video.mp4" },
        { "type": "text", "text": "Hello world", "duration": 5 },
        { "type": "image", "src": "https://images.pexels.com/photos/1105666/pexels-photo-1105666.jpeg", "width": 1620, "height": 1080, "x": 0, "y": 0 },
        { "type": "component", "component": "basic/001", "settings": { "headline": { "text": "Lorem ipsum" } } },
        { "type": "html", "html": "<h1>Hello world</h1>", "width": 800, "height": 600 },
        { "type": "audio", "src": "https://example.com/audio.mp3", "duration": 5 },
        { "type": "voice", "text": "This is a voiceover.", "voice": "en-US-Wavenet-D" },
        { "type": "audiogram", "color": "#00FF00", "amplitude": 5 },
        { "type": "subtitles", "captions": "1\n00:00:00,000 --> 00:00:02,000\nHello world!" }
      ]
    }
  ]
}

Notes for Users:

Each element type has its own required and optional properties. See https://json2video.com/docs/api/ for full details.
You can mix and match element types in scenes and globally.
For custom resolutions, set both width and height.
Use the returned project ID to check video status with get_video_status.

Output:

Returns a project ID to be used with get_video_status.

2. Get Video Status (`get_video_status`)

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

Description: Retrieves the status or result of a previously started video generation job. Note: Video rendering is asynchronous and may take some time. If the status is not "done", please try again later using the same project ID.

Input Schema:

{
  "project": "string (required)",
  "apiKey": "string (optional)"
}

Example Input:

{
  "project": "q663vmm2"
}

Example Output:

{
  "success": true,
  "movie": {
    "success": true,
    "status": "done",
    "message": "",
    "project": "q663vmm2",
    "url": "https://assets.json2video.com/clients/yourclient/renders/yourvideo.mp4",
    "created_at": "2025-04-27T10:44:18.880Z",
    "ended_at": "2025-04-27T10:44:28.589Z",
    "duration": 11,
    "size": 359630,
    "width": 640,
    "height": 360,
    "rendering_time": 10
  }
}

3. Create Template (`create_template`)

Create a new template in json2video.

Description: Creates a new template with a given name and optional description.

Input Schema:

{
  "name": "string (required, name of the template)",
  "description": "string (optional, description of the template)",
  "apiKey": "string (optional)"
}

Example Input:

{
  "name": "MyTemplate",
  "description": "A reusable video template."
}

Output:

Returns the template ID if successful.

4. Get Template (`get_template`)

Get template details from json2video.

Description: Retrieves details of a template by its name.

Input Schema:

{
  "name": "string (required, name of the template)",
  "apiKey": "string (optional)"
}

Example Input:

{
  "name": "MyTemplate"
}

Output:

{
    "updated_at": "YYYY-MM-DDTHH:MM:SSZ",
    "created_at": "YYYY-MM-DDTHH:MM:SSZ",
    "movie": "{\"id\":\"template1\",\"comment\":\"Example template\",\"resolution\":\"full-hd\",\"quality\":\"high\",\"scenes\":[{\"id\":\"scene1\",\"comment\":\"Scene 1\",\"elements\":[]}],\"elements\":[],\"width\":1920,\"height\":1080}",
    "name": "MyTemplate",
    "id": "MyTemplate_ID"
  }

5. List Templates (`list_templates`)

List all available templates from json2video.

Description: Lists all templates available to the user.

Input Schema:

{
  "apiKey": "string (optional)"
}

Example Input:

{
}

Output:

[
  {
    "updated_at": "YYYY-MM-DDTHH:MM:SSZ",
    "created_at": "YYYY-MM-DDTHH:MM:SSZ",
    "movie": "{\"id\":\"template1\",\"comment\":\"Example template\",\"resolution\":\"full-hd\",\"quality\":\"high\",\"scenes\":[{\"id\":\"scene1\",\"comment\":\"Scene 1\",\"elements\":[]}],\"elements\":[],\"width\":1920,\"height\":1080}",
    "name": "MyTemplate1",
    "id": "TEMPLATE_ID_1"
  },
  {
    "updated_at": "YYYY-MM-DDTHH:MM:SSZ",
    "created_at": "YYYY-MM-DDTHH:MM:SSZ",
    "movie": "{\"id\":\"template2\",\"resolution\":\"instagram-story\",\"quality\":\"medium\",\"scenes\":[{\"id\":\"scene2\",\"comment\":\"Scene 2\",\"elements\":[]}],\"elements\":[],\"comment\":\"Another template\"}",
    "name": "MyTemplate2",
    "id": "TEMPLATE_ID_2"
  }
]

Available Tools

5 tools

create_templateC

Create a new template in json2video

Inputs: name (required), apiKey, description.

generate_videoC

Creates a video project using the json2video API. Each project can contain multiple scenes, and each scene can contain various elements such as text, images, video, audio, components, HTML, voice, audiogram, and subtitles. See https://json2video.com/docs/api/ for full schema.

Inputs: scenes (required), id, comment, cache, +9 more.

get_templateB

Get template details from json2video

Inputs: name (required), apiKey.

get_video_statusB

Get the status or result of a generated video

Inputs: project (required), apiKey.

list_templatesB

List all available templates from json2video

Inputs: apiKey.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

Deploy Server

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

TDQS

A3.5/5.0

Scored 2026-06-12 11:35 across 5 tools

Disambiguation5/5

Each tool has a clearly distinct purpose: creating templates, generating videos, retrieving template details, checking video status, and listing templates. There is no ambiguity or overlap between them.

Naming Consistency5/5

All tool names follow a consistent verb_noun pattern in snake_case (create_template, generate_video, get_template, get_video_status, list_templates), making them predictable and easy to understand.

Tool Count5/5

5 tools is an appropriate number for a video generation server with template management. It covers the core operations without being overwhelming or insufficient.

Completeness4/5

The tool set covers template creation, retrieval, and listing, as well as video generation and status checking. Minor gaps exist, such as missing update and delete operations for templates, but the primary workflow is well-supported.

Maintenance

ActivityInactive

ResponsivenessNo recent community issues

Resources

Related MCP Connectors

Shotstack
io.shotstack
Generate, edit, and render videos via the Shotstack video editing API.
Multimedia Processing Image & Video Processing
1
https://mcp.shotstack.io/
Templated
io.github.templated-io
Generate images, videos and PDFs from templates. Manage templates, folders, uploads and fonts.
Design Tools Marketing
13
https://mcp.templated.io/mcp
Zvid
io.zvid
Zvid: render videos & images from JSON; manage templates, projects, webhooks & credits.
Image & Video Processing Multimedia Processing
2
https://mcp.zvid.io/mcp
VideoGenA
io.github.dg314
Create and edit videos, images, voiceovers, music, and avatars with the VideoGen API.
Audio Processing Image & Video Processing Multimedia Processing
5814
https://mcp.videogen.io/mcp

Related MCP Servers

Sisif AI MCP Server
Image & Video Processing AI & Machine Learning Multimedia Processing
vtemian
A
license
Not graded
quality
D
maintenance
Enables AI video generation from text prompts, status monitoring, and video management through the Sisif AI Video API.
Updated 10 months ago (2025-12-29 14:14 UTC)
1
MIT
Agnes Video MCP Server
AI & Machine Learning Image & Video Processing
kira4094
A
license
A
quality
D
maintenance
Enables video generation from text prompts or images using Agnes AI's video models, with async task submission and status polling.
Updated 5 months ago (2026-06-25 01:08 UTC)
2
19 npm
1
MIT
iLoveVideoEditor MCP Serverofficial
Image & Video Processing Multimedia Processing
ilovevideoeditor
A
license
A
quality
D
maintenance
Enables AI agents to render videos with iLoveVideoEditor by listing templates, filling in variables, submitting render jobs, polling status, and retrieving download URLs.
Updated 4 months ago (2026-07-15 01:36 UTC)
10
85 npm
Apache 2.0
pictory-mcp
Multimedia Processing Image & Video Processing
softreviewed
A
license
B
quality
B
maintenance
Enables AI assistants and coding agents to automate Pictory.ai video creation, including 1080p rendering, transcription into viral short clips, AI avatars, stock asset search, project/template management, and publishing to Vimeo and S3.
Updated 12 days ago (2026-11-02 12:08 UTC)
5
MIT

json2video MCP Server

Features

Installation

Running with npx

Manual Installation

Windows Users

Running on Cursor

Cursor v0.48.6+

Cursor v0.48.6+

MCP Integration Example

Configuration

Environment Variables

Usage

Available Tools

1. Generate Video (generate_video)

2. Get Video Status (get_video_status)

3. Create Template (create_template)

4. Get Template (get_template)

5. List Templates (list_templates)

Available Tools

Tool Schema Changelog

TDQS

Maintenance

Resources

Related MCP Connectors

Related MCP Servers

Sisif AI MCP Server

Agnes Video MCP Server

iLoveVideoEditor MCP Serverofficial

pictory-mcp

1. Generate Video (`generate_video`)

2. Get Video Status (`get_video_status`)

3. Create Template (`create_template`)

4. Get Template (`get_template`)

5. List Templates (`list_templates`)