# JSON2Video

> JSON2Video is a freemium MCP server for design and media. Render videos from templates with voiceovers and subtitles through the JSON2Video API. It can run locally on your machine or as a hosted remote server.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Platforms:** API, CLI, Web
- **Website:** https://json2video.com/docs/v2/help-for-ai-agents/mcp-server
- **Repository:** https://github.com/json2video/json2video-mcp
- **MCP Registry name:** com.json2video/mcp
- **Categories:** design and media
- **Listing updated:** 2026-11-14

## About

A render does not block the chat. The server returns a project ID quickly and the assistant polls it with check_status or list_recent_renders, so long videos keep rendering in the background. A finished render comes back as a URL to an MP4 you can publish.

An assistant can build a video from a prompt, validate the movie JSON, browse and save templates, upload media and report remaining credits. Prompts the docs suggest include a 30-second vertical sale announcement from three product photos, or rendering a real-estate template once for each of ten properties. The pricing page says JSON2Video does not natively generate AI images, AI video or avatars, although the README mentions AI-generated images.

There are two versions with the same tools. The remote server at https://mcp.json2video.com/mcp signs in with your JSON2Video account and needs no API key; its media_upload accepts public URLs up to 50 MB. The local @json2video/cli package runs over stdio, which suits CI, offline work and uploading files from disk.

## Features

- **Template-based rendering:** Builds finished videos from reusable templates, including batch renders such as one per property listing.
- **Render status checks:** check_status and list_recent_renders let the assistant follow long renders without waiting.
- **Movie JSON validation:** Checks a video definition before spending credits on a render.
- **Template library access:** Browse and save templates from the assistant.
- **Media upload:** media_upload takes public URLs up to 50 MB on the remote server; the local server can use files from disk.
- **Account sign-in:** The remote server connects via OAuth and creates a revocable key per connected app.

## Good for

- Make a vertical promo video from product photos
- Render one templated video per property or product
- Create a template for daily news shorts
- Add a logo watermark to an existing video
- Check remaining render credits

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http mcp https://mcp.json2video.com/mcp
```

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://mcp.json2video.com/mcp
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "mcp": {
      "url": "https://mcp.json2video.com/mcp"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "mcp": {
      "type": "http",
      "url": "https://mcp.json2video.com/mcp"
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "mcp": {
      "serverUrl": "https://mcp.json2video.com/mcp"
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "mcp": {
      "type": "http",
      "url": "https://mcp.json2video.com/mcp"
    }
  }
}
```

## Tools

- `check_status`: Checks the progress of a render by project ID.
- `list_recent_renders`: Lists recent renders.
- `media_upload`: Uploads media from a public URL up to 50 MB on the remote server.

## FAQ

### Do I need an API key?

Not for the remote server: you sign in and approve the connection. The local package needs a JSON2VIDEO_API_KEY.

### Is there a free plan?

Yes, 600 credits with no card needed, but free-plan videos carry a watermark.

### How are credits used?

One credit per second of rendered video, regardless of resolution. External text-to-speech or transcription services may cost extra.

### Can I upload local files?

The remote server only accepts public URLs up to 50 MB. Use the local server or the dashboard for files on your computer.

### Which clients work?

The docs cover Claude, ChatGPT, Claude Code, Cursor and VS Code, with the local server for editors such as Windsurf.

### Is JSON2Video free?

JSON2Video has a free plan, with paid plans for more usage or features.

### How do I add JSON2Video to Claude Code?

Run this command in your terminal: claude mcp add --transport http mcp https://mcp.json2video.com/mcp

### What are the best alternatives to JSON2Video?

The closest alternatives to JSON2Video are HyperFrames by HeyGen, ffmpeg-skill, AvatarSay — Fictional Character & Talking Video MCP, ChartAnt and VfxSmith.

## Alternatives

- [HyperFrames by HeyGen](https://ai-powered.com/mcp/hyperframes-by-heygen): HyperFrames by HeyGen is a freemium MCP server for design and media.
- [ffmpeg-skill](https://ai-powered.com/mcp/ffmpeg-skill): ffmpeg-skill is an open-source MCP server for design and media.
- [AvatarSay — Fictional Character & Talking Video MCP](https://ai-powered.com/mcp/avatarsay-fictional-character-and-talking-video-mcp): AvatarSay — Fictional Character & Talking Video MCP is a freemium MCP server for design and media.
- [ChartAnt](https://ai-powered.com/mcp/chartant): ChartAnt is a freemium MCP server for design and media.
- [VfxSmith](https://ai-powered.com/mcp/vfxsmith): VfxSmith is a freemium MCP server for design and media.
- [CalderFlow](https://ai-powered.com/mcp/calderflow): CalderFlow is a free MCP server for design and media.
- [Eikino](https://ai-powered.com/mcp/eikino): Eikino is a freemium MCP server for security.
- [Hourlore](https://ai-powered.com/mcp/hourlore): Hourlore is a freemium MCP server for design and media.

---
Source: https://ai-powered.com/mcp/json2video
