Skip to content
MCP server

Kinocut

Local MCP server and CLI that lets AI agents edit video with FFmpeg guardrails

Runs locallyStatus and history
Pricing
Open source
Platforms
CLI, macOS, Linux
Runs
Locally
Version
2.0.1
Listing updated
3 days ago

About Kinocut

Kinocut is an open-source MCP server for design and media. It runs locally on your machine and is started by your AI client.

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.

Install

Run in a terminal

claude mcp add kinocut -- uvx kinocut

Add to claude_desktop_config.json

{
  "mcpServers": {
    "kinocut": {
      "command": "uvx",
      "args": [
        "kinocut"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "kinocut": {
      "command": "uvx",
      "args": [
        "kinocut"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

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

Add to ~/.codeium/windsurf/mcp_config.json

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

Add to your client's MCP settings (most use this shape)

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

Tools this server provides (11)

Taken from the project documentation; the running server may differ.

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

What it does

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

Pricing

Open source

Free, Apache-2.0; no credits

Prices change. Check kinocut.dev before you buy.

Kinocut 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 to Kinocut

  1. Hosted MCP connector for creating and rendering videos from HTML through AI chat

    • Remote
    • Freemium
    • 85.3K GitHub stars
    • Design and media
  2. ffmpeg-skill

    MCP server

    Local FFmpeg video and audio editing tools for coding agents over MCP

    Runs locally
    • Open source
    • 6.9K GitHub stars
    • Design and media
  3. ChartAnt

    MCP server

    Remote MCP server returning charts, maps and dashboards as hosted PNG links

    • 51 tools
    • Remote
    • Freemium
    • Design and media
  4. VfxSmith

    MCP server

    Search, generate, refine and export pixel art game effects from Claude Code or Codex

    Not checked yet
    • Remote
    • Freemium
    • Design and media
  5. CalderFlow

    MCP server

    Turn notes or specs into editable flowcharts, timelines and funnels from an AI assistant

    • 10 tools
    • Remote
    • Free
    • Design and media