# mcp-video

> mcp-video is an open-source MCP server for design and media. Local MCP server that gives AI agents guardrailed FFmpeg video editing tools. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, macOS, Windows, Linux, self-hosted
- **Website:** https://kinocut.dev
- **Repository:** https://github.com/kyanitelabs/kinocut
- **MCP Registry name:** io.github.KyaniteLabs/mcp-video
- **Categories:** design and media
- **Listing updated:** 2026-11-14

## About

Rather than letting an agent guess FFmpeg flags, Kinocut exposes typed editing tools that are checked before anything renders. Edits write to a new file unless an overwrite is allowed, and each call returns a structured result the agent can read back. Quality gates look for black frames, silence and poor loudness before a cut reaches you.

Every workflow ends with a Video Receipt, a JSON record of what was asked, which tools ran, which guardrails fired and what still needs a human look. The site's headline job is turning a local interview into captioned vertical clips. The registry package named mcp-video is a compatibility shim: it installs Kinocut, the project's new name.

To keep token use down, the default tool list is small: eight hot-path tools, eight operation families and two discovery tools (`list_operations`, `describe_operation`). Setting `KINOCUT_TOOLS` switches to a named profile or to the full catalog of about 200 tools. Everything runs on your own machine with FFmpeg installed, with no account, upload or credits.

## Features

- **Preflight guardrails:** Parameters are validated before FFmpeg runs, catching out-of-range filters, mismatched merges and broken audio maps.
- **Video Receipt:** Each workflow writes a JSON record of the request, tools run, guardrails fired and items needing human review.
- **Quality gates:** Checks for black frames, silence and loudness run before the cut is handed back.
- **Small default tool list:** Eight hot-path tools plus operation families keep the listing short; the rest are reached via list_operations and describe_operation.
- **Tool profiles:** KINOCUT_TOOLS selects one of the job-specific profiles or exposes every tool by name.
- **Non-destructive output:** Edits go to a new file unless an overwrite is explicitly allowed.
- **Local-first:** Runs on your machine with no account, upload or credit meter.

## Good for

- Cut an interview into captioned vertical shorts
- Trim, merge and add audio or text to clips from an agent
- Extract frames from a video for review
- Check a render for sync, silence and loudness problems
- Keep an auditable record of what an agent changed in an edit

## Install

### Claude Code (Terminal)

```sh
claude mcp add mcp-video -- uvx mcp-video
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "mcp-video": {
      "command": "uvx",
      "args": [
        "mcp-video"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "mcp-video": {
      "command": "uvx",
      "args": [
        "mcp-video"
      ]
    }
  }
}
```

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

```json
{
  "servers": {
    "mcp-video": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "mcp-video"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "mcp-video": {
      "command": "uvx",
      "args": [
        "mcp-video"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "mcp-video": {
      "command": "uvx",
      "args": [
        "mcp-video"
      ]
    }
  }
}
```

## Tools

- `video_info`: Reads details about a video file.
- `video_trim`: Trims a video to a time range.
- `video_merge`: Joins video clips together.
- `video_add_text`: Adds text to a video.
- `video_add_audio`: Adds an audio track to a video.
- `video_extract_frame`: Pulls a still frame out of a video.
- `video_shorts`: Builds short vertical clips from a video.
- `video_doctor`: Checks which features are ready on the machine.

## FAQ

### Is mcp-video the same as Kinocut?

Yes. The project was renamed, and the mcp-video package now installs Kinocut.

### What do I need installed?

FFmpeg on your PATH, plus Python with uvx or pip. `kino doctor` reports which features are ready.

### Does it upload my footage?

No. The README says everything runs locally with no account, upload or credits.

### How many tools does the agent see?

By default 18. Setting KINOCUT_TOOLS=all lists every tool by name.

### What licence is it under?

Apache-2.0.

### Is mcp-video free?

Yes. mcp-video is open source, so you can use and self-host it for free.

### How do I add mcp-video to Claude Code?

Run this command in your terminal: claude mcp add mcp-video -- uvx mcp-video

### What are the best alternatives to mcp-video?

The closest alternatives to mcp-video 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/mcp-video
