
mcp-video
Local MCP server that gives AI agents guardrailed FFmpeg video editing tools
- 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-videoAdd to claude_desktop_config.json
{
"mcpServers": {
"mcp-video": {
"command": "uvx",
"args": [
"mcp-video"
]
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"mcp-video": {
"command": "uvx",
"args": [
"mcp-video"
]
}
}
}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

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