
Kinocut
Local MCP server and CLI that lets AI agents edit video with FFmpeg guardrails
- 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 kinocutAdd to claude_desktop_config.json
{
"mcpServers": {
"kinocut": {
"command": "uvx",
"args": [
"kinocut"
]
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"kinocut": {
"command": "uvx",
"args": [
"kinocut"
]
}
}
}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

HyperFrames by HeyGen
MCP serverHosted MCP connector for creating and rendering videos from HTML through AI chat
- Remote
- Freemium
- 85.3K GitHub stars
- Design and media

ffmpeg-skill
MCP serverLocal FFmpeg video and audio editing tools for coding agents over MCP
Runs locally- Open source
- 6.9K GitHub stars
- Design and media

Generate fictional character portraits and lip-synced talking videos from text over MCP
- 10 tools
- Remote
- Freemium
- Design and media

ChartAnt
MCP serverRemote MCP server returning charts, maps and dashboards as hosted PNG links
- 51 tools
- Remote
- Freemium
- Design and media

VfxSmith
MCP serverSearch, generate, refine and export pixel art game effects from Claude Code or Codex
Not checked yet- Remote
- Freemium
- Design and media

CalderFlow
MCP serverTurn notes or specs into editable flowcharts, timelines and funnels from an AI assistant
- 10 tools
- Remote
- Free
- Design and media