json2video MCP Server

What is json2video MCP Server?

A Model Context Protocol (MCP) server for programmatically generating videos via the json2video API. It exposes tools for video generation, status checking, and template management to LLMs, agents, or any MCP-compatible client.

How to use json2video MCP Server?

Install and run with env JSON2VIDEO_API_KEY=your_api_key_here npx -y @omerrgocmen/json2video-mcp, or install globally with npm install -g @omerrgocmen/json2video-mcp. Set the JSON2VIDEO_API_KEY environment variable with your API key from json2video.com. The server provides generate_video, get_video_status, create_template, get_template, and list_templates tools.

Key features of json2video MCP Server

• Rich scene and element support (text, image, video, audio, components, HTML, voice, audiogram, subtitles)
• Asynchronous video rendering with status polling via project ID
• API key authentication via environment variable or per-request
• Template creation, retrieval, and listing for reusable projects
• Flexible JSON schema supporting custom resolutions and multiple scenes

Use cases of json2video MCP Server

• Programmatic video generation from LLMs and AI agents
• Automating video production with dynamic scenes and elements
• Creating and reusing video templates for recurring content
• Checking rendering status of asynchronous video jobs

FAQ from json2video MCP Server

What tools does the server expose?

It exposes generate_video, get_video_status, create_template, get_template, and list_templates.

How do I get a json2video API key?

Obtain your API key from the json2video website at https://json2video.com.

Is video rendering synchronous or asynchronous?

Video generation is asynchronous. Use the returned project ID with get_video_status to poll until status is "done".

What element types can I include in a scene?

Text, image, video, audio, component, HTML, voice, audiogram, and subtitles elements are supported.

What are the runtime requirements?

Node.js and npm are required. The server needs an active internet connection to reach the json2video API.