json2video

The json2video MCP Server exposes two primary tools: generate_video and get_video_status. You can start a new video rendering job by calling generate_video with a detailed project schema compatible with json2video's API (scenes, elements, resolution, and optional API key). The server handles asynchronous rendering by returning a project ID, which you can subsequently poll with get_video_status to retrieve progress or the final video URL. This makes it suitable for agents and LLM workflows that orchestrate long-running tasks across multiple steps. When integrated, you can pass the API key either via the JSON body or rely on the configured environment variable, depending on how your MCP client is implemented. The server also supports error handling and logging, helping you diagnose issues from invalid schemas to authentication problems.

Prerequisites:

• Node.js and npm installed
• Access to the internet to fetch packages from npm

Installation steps:

1. Install the MCP server globally via npx (recommended): env JSON2VIDEO_API_KEY=your_api_key_here npx -y @omerrgocmen/json2video-mcp
2. Alternatively, install the package globally for local usage: npm install -g @omerrgocmen/json2video-mcp
3. If you encounter issues on Windows, set the API key inline and run via npx: cmd /c "set JSON2VIDEO_API_KEY=your_api_key_here && npx -y @omerrgocmen/json2video-mcp"
4. After installation, you can configure MCP integration in mcp.json as shown in the example to auto-start the server with your client code.

Environment variable guidance:

• JSON2VIDEO_API_KEY is required (or provided per request by your client).
• You can override the key per request by passing it in the input payload where supported by your MCP client. Common issues:
• client closed errors: ensure the package is installed and the API key is valid.
• rate limits or authentication failures: verify the API key and monitor usage according to json2video docs.
• For debugging, you can run npm i @omerrgocmen/json2video-mcp to ensure the client library is present in your environment.