Skip to content
MCP server

mcp-video

Local MCP server that gives AI agents guardrailed FFmpeg video editing tools

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

About mcp-video

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

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.

Install

Run in a terminal

claude mcp add mcp-video -- uvx mcp-video

Add to claude_desktop_config.json

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

Add to ~/.cursor/mcp.json

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

Add to .vscode/mcp.json

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

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

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

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

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

Tools this server provides (8)

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

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.

What it does

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

Pricing

Open source

Free, Apache-2.0

Prices change. Check kinocut.dev before you buy.

mcp-video 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 to mcp-video

  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