Overview
json2video MCP Server is an MCP server implementation that enables programmatic video generation via the json2video API. It exposes tooling for creating video projects with multiple scenes and a broad range of elements (text, image, video, audio, components, HTML, subtitles, etc.) and supports asynchronous rendering with status polling. The server uses an extensible JSON schema to configure quality, resolution (with custom width/height when needed), and per-scene settings. It provides tools to generate_video (returning a project ID) and get_video_status (to poll for completion and retrieve the final URL and metadata), as well as template management via create_template, get_template, and list_templates. Authentication is supported through the JSON2VIDEO_API_KEY, either as an environment variable or per-request. The MCP server is designed for easy integration with LLMs, automation agents, and other MCP-compatible clients, including built-in error handling and logging. It also includes Cursor integration guidance for quick setup and discovery of the server. Overall, it enables automated video generation workflows within MCP-enabled environments with robust status reporting.
Features
Generate videos with rich scene and element support
Create video projects spanning multiple scenes and a variety of elements (text, image, video, audio, components, subtitles, HTML, etc.).
Asynchronous video rendering with status polling
Video rendering is asynchronous; poll status to track progress and retrieve results.
Flexible, extensible JSON schema for video projects
Extensible JSON schema to configure scenes, elements, and project-level settings.
Designed for easy integration with LLMs, automation agents, and MCP-compatible tools
Built for seamless integration with LLMs, automation agents, and other MCP-compatible clients.
API key authentication (env or per-request)
Supports API key authentication via environment variables or per-request parameters.
Comprehensive error handling and logging
Includes robust error handling and logging for reliable operation.
Cursor integration support
Guidance and tooling for Cursor integration to quickly discover and configure the MCP server.
Template management (create_template, get_template, list_templates)
Manage video templates via json2video API for reuse across projects.
Who Is This For?
- LLMs:Orchestrate video generation requests and monitor results using natural language prompts.
- Automation agents:Trigger and track video jobs within automated workflows and decision pipelines.
- MCP clients:MCP-compatible clients can start video projects and poll status via the provided tools.
