# Kinocut

> Kinocut is an open-source MCP server for design and media. Local MCP server and CLI that lets AI agents edit video with FFmpeg guardrails. It runs locally on your machine and is started by your AI client.

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

## About

Kinocut is the new name of mcp-video. It sits between an agent and FFmpeg: each edit is checked before the render, writes to a new file unless you allow an overwrite, and returns a structured result the agent can read back. Quality gates look for black frames, silence and bad loudness before you see the cut.

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 sample receipt on the site shows a podcast turned into three vertical clips, with a quality score, loudness reading and word-timed captions.

The default tool list is kept small, 18 entries, with eight operation families that reach the rest on demand, so the agent does not pay for hundreds of tool descriptions every turn. The full catalogue is about 206 tools. Everything runs on your machine with FFmpeg installed.

## Features

- **Preflight guardrails:** Out-of-range filters, mismatched merges and broken audio maps are caught and explained before FFmpeg renders.
- **Video Receipts:** Each workflow produces a JSON record of the request, tools run, guardrails fired and items left for human review.
- **Quality gates:** Checks for black frames, silence and loudness run before the cut reaches you.
- **Compact tool listing:** 18 tools by default, with operation families and list_operations/describe_operation reaching the rest.
- **Tool profiles:** KINOCUT_TOOLS can select one of 19 job profiles or expose all 206 tools by name.
- **Safe file handling:** Edits go to a new file unless you explicitly allow an overwrite.

## Good for

- Cut a local interview into captioned vertical clips
- Merge and trim footage through an agent without guessing FFmpeg flags
- Check loudness, silence and black frames before a cut is reviewed
- Keep an auditable record of what an agent did to a video
- Review a cut through an HTML card in Hermes Desktop

## Install

### Claude Code (Terminal)

```sh
claude mcp add kinocut -- uvx kinocut
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "kinocut": {
      "command": "uvx",
      "args": [
        "kinocut"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "kinocut": {
      "command": "uvx",
      "args": [
        "kinocut"
      ]
    }
  }
}
```

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

```json
{
  "servers": {
    "kinocut": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "kinocut"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "kinocut": {
      "command": "uvx",
      "args": [
        "kinocut"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "kinocut": {
      "command": "uvx",
      "args": [
        "kinocut"
      ]
    }
  }
}
```

## Tools

- `video_info`: Reads information about a video file
- `video_trim`: Trims a video
- `video_merge`: Merges clips
- `video_add_text`: Adds text to a video
- `video_add_audio`: Adds audio to a video
- `video_extract_frame`: Extracts a frame
- `video_shorts`: Cuts short vertical clips
- `video_doctor`: Checks which features are ready
- `list_operations`: Lists the operations in a family
- `describe_operation`: Returns one operation's full schema
- `video_review_card`: Writes an HTML review card with a contact sheet

## FAQ

### Does it upload my video?

No. The site says everything runs locally, with no upload, no account and no credits.

### What does it need installed?

FFmpeg on your PATH. Install with uvx, pip install kinocut, or add it to Claude Code with claude mcp add.

### What licence is it under?

Apache-2.0.

### How many tools does it expose?

18 by default; the full catalogue is 206 tools, selectable with the KINOCUT_TOOLS setting.

### Is Kinocut free?

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

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

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

### What are the best alternatives to Kinocut?

The closest alternatives to Kinocut 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/kinocut
