local MCP · agent edit suite MCP local · suite de edición agéntica
KINOCUT
Guardrailed video editing for AI agents — inspectable, scored, human-gated. Edición de video con barreras para agentes de IA — inspeccionable, evaluada, con puerta humana.
Kinocut (formerly mcp-video) is a local-first
Model Context Protocol (MCP) server, Python library, and kino CLI.
Agents get typed FFmpeg tools with preflight guardrails before the render, a Video Receipt after it,
and quality gates in between. Free under Apache-2.0. No upload. No credit meter.
Primary job: turn a local interview into captioned vertical clips with a Video Receipt.
Kinocut (antes mcp-video) es un
servidor MCP local, biblioteca Python y CLI kino.
Los agentes obtienen herramientas FFmpeg tipadas con barreras antes del render,
un Video Receipt después, y controles de calidad en el medio. Gratis bajo Apache-2.0.
Sin subir material. Sin medidor de créditos.
Trabajo principal: convertir una entrevista local en clips verticales con recibo.
$ pip install kinocut
$ claude mcp add kinocut -- uvx --from kinocut kino
$ kino doctor
$ # clone → prove it works
$ python scripts/golden_path.pyGolden path (clone): doctor → vertical proof clip → Video Receipt. docs/GOLDEN_PATH.md Ruta dorada (clone): doctor → clip vertical de prueba → Video Receipt. docs/GOLDEN_PATH.md
VIDEO RECEIPT kc-2026-0710-041
- intent
- podcast → 3 vertical clips podcast → 3 clips verticales
- tools run
- 7
- guardrails
- 2 warned · 0 failed
- quality
- score 84 · pass
- a/v sync
- ok
- loudness
- -14.1 LUFS
- captions
- word-timed
- sources
- sha256 · 9b41…c2
- output
- sha256 · 55d0…8f
- human review
- hook + thumbnail gancho + miniatura
- 1.15.0latest releaseúltima versión
- 196MCP tools publishedherramientas MCP publicadas
- Apache-2.0free & open sourcegratis y open source
- localno upload · no creditssin subida · sin créditos
- MCPClaude Code · Cursor · CLIClaude Code · Cursor · CLI
Proof on the site — this cut was assembled with Kinocut Prueba en el sitio — este corte se armó con Kinocut
Product film: process-bay world, real image-to-video motion, terminal B-roll, Hyperframes chrome, and an EDITED WITH KINOCUT end card. Preflight, receipt, and inspectable cut — not a slideshow. Película de producto: bahía de proceso, motion real image-to-video, B-roll de terminal, chrome Hyperframes y tarjeta final EDITED WITH KINOCUT. Preflight, receipt y corte inspeccionable — no un slideshow.
An edit you can’t inspect is an edit you can’t trust. Una edición que no puedes inspeccionar no es una edición en la que puedas confiar.
Three gates between an agent and a bad render Tres compuertas entre un agente y un mal render
Guardrails on every risky parameter Barreras en cada parámetro riesgoso
Out-of-range filters, mismatched merges, broken audio maps, overflowing text — caught and explained before FFmpeg renders a single frame. 196 structured MCP tools in published 1.15.0, every parameter validated server-side. Filtros fuera de rango, uniones incompatibles, audio mal mapeado, texto desbordado — detectados y explicados antes de que FFmpeg genere un solo cuadro. 161 herramientas MCP en la 1.15.0 publicada, cada parámetro validado en el servidor.
Every workflow leaves a paper trail Cada flujo deja constancia
What was asked, which tools ran, what changed, which guardrails fired, and what still needs human eyes — one JSON receipt per workflow, checkable by the next agent or the next person. Qué se pidió, qué herramientas corrieron, qué cambió, qué barreras se activaron y qué falta revisar por una persona — un recibo JSON por flujo, verificable por el próximo agente o la próxima persona.
Scored output, human checkpoints Salida evaluada, puntos de control humanos
VMAF, loudness, black-frame and A/V-sync checks score the result; release checkpoints hold anything below the bar. Humans stay exactly where they matter — hooks, thumbnails, final review. VMAF, sonoridad, cuadros negros y sincronía A/V evalúan el resultado; los puntos de control retienen lo que no llega a la barra. Las personas quedan justo donde importan — ganchos, miniaturas, revisión final.
Watch an agent work Mira a un agente trabajar
› turn ep-42.mp4 into three vertical clips with captionsconvierte ep-42.mp4 en tres clips verticales con subtítulos
kino repurpose ep-42.mp4 --platform shorts --count 3
✓ preflight 0 failures · 2 warnings clamped
✓ transcribe 41:32 · whisper · local
✓ select moments 3 segments · keyword + energy
✓ reframe 9:16 speaker-tracked
✓ captions word-timed · burned
✓ quality gate score 84 · pass
◉ receipt out/receipt.json · 2 items for human review2 puntos para revisión humanaVerbs agents actually pick right Verbos que los agentes eligen bien
A small set of intent-level verbs up front — 196 structured MCP tools in published 1.15.0 underneath for when you need the depth: effects, transitions, audio synthesis, analysis, Hyperframes HTML-native rendering, workflow receipts, and video rescue. Un conjunto pequeño de verbos de intención al frente — 196 herramientas MCP en la 1.15.0 publicada debajo para cuando necesitas profundidad: efectos, transiciones, síntesis de audio, análisis, render HTML-nativo con Hyperframes, recibos de flujo y rescate de video.
- repurpose
- trim
- merge
- subtitle
- reframe
- remove_silence
- normalize
- storyboard
- glitch
- + 196 tools
Runs where your footage lives Corre donde vive tu material
- no uploadsin subir nada Your media never leaves your machine. FFmpeg and Whisper run locally. Tu material nunca sale de tu máquina. FFmpeg y Whisper corren localmente.
- no credit metersin medidor de créditos A 3-hour podcast costs the same as a 30-second clip: nothing. Un podcast de 3 horas cuesta lo mismo que un clip de 30 segundos: nada.
- no watermarksin marca de agua Apache-2.0. Client work is your work. Apache-2.0. El trabajo para clientes es tuyo.
- no phoning homesin telemetría Zero analytics, zero accounts, zero keys required for the core. Cero analíticas, cero cuentas, cero llaves para el núcleo.
What is Kinocut? ¿Qué es Kinocut?
Kinocut is an open-source video editing MCP server
for AI agents, plus a matching Python client and kino CLI. It runs locally on
FFmpeg, exposes 196 structured tools in published 1.15.0, and is
designed so agent-produced media can be inspected, scored, and human-reviewed before publish.
The official package is kinocut on PyPI; the MCP Registry id is
io.github.KyaniteLabs/kinocut; the product site is kinocut.dev.
Kinocut es un servidor MCP de edición de video
de código abierto para agentes de IA, más un cliente Python y la CLI kino. Corre
localmente sobre FFmpeg, expone 196 herramientas estructuradas en la
1.15.0 publicada, y está pensado para que el video hecho por agentes se pueda
inspeccionar, evaluar y revisar por humanos antes de publicar. El paquete oficial es
kinocut en PyPI; el id del MCP Registry es io.github.KyaniteLabs/kinocut;
el sitio del producto es kinocut.dev.
- forpara Claude Code, Cursor, and any MCP client; also scripts and CI via Python/CLI. Claude Code, Cursor y cualquier cliente MCP; también scripts y CI vía Python/CLI.
- notno es A hosted cloud editor, a credit-metered SaaS, or an untyped FFmpeg shell wrapper. Un editor en la nube, un SaaS con créditos, ni un wrapper de FFmpeg sin tipos.
-
also calledtambién
kino(CLI), formerlymcp-video/mcp_video.kino(CLI); antesmcp-video/mcp_video.
Where this is going Hacia dónde va
Published today is 1.15.0 (196 MCP tools / 167 CLI). Development tip matches published 1.15.0: 196 MCP tools / 167 CLI (360 assembly + intent/watching/TE + still/plate). Hoy está publicada la 1.15.0 (196 herramientas MCP / 167 CLI). La punta de desarrollo coincide con la 1.15.0 publicada: 196 herramientas MCP / 167 CLI (ensamblaje 360 + intent/watching/TE + still/plate).
-
publishedpublicado
1.15.0: first-class Windows MCP and honest
--mcp/ doctor diagnostics. 1.15.0: MCP de Windows de primera clase y diagnósticos honestos de--mcp/ doctor. Same 196/167 surface as 1.14.1 (360 assembly, intent/watching/TE). A stitched equirect MP4 becomes a reviewable two-cam edit (split / switch / PiP / single) without a new MCP name. Raw.insv/ GoPro.360stay rejected. Full-episode sound claims still require human and cross-platform evidence. Misma superficie 196/167 que 1.14.1 (ensamblaje 360, intent/watching/TE). Un MP4 equirectangular ya stitched se convierte en un edit de dos cámaras revisable (split / switch / PiP / single) sin un nombre MCP nuevo. Se rechazan.insvy GoPro.360. Las afirmaciones de audio de episodio completo aún requieren evidencia humana y multiplataforma. -
development tippunta de desarrollo
Durable editing substrate.Sustrato de edición durable. Projects, content-addressed assets, resumable render jobs, lineage receipts, semantic selections, reusable recipes, and kernel-backed repurposing are implemented on
master. They wrap the existing workflow engine; they do not replace it. Proyectos, activos por contenido, trabajos reanudables, recibos de linaje, selecciones semánticas, recetas reutilizables y repurpose respaldado por el kernel están implementados enmaster. Envuelven el motor de flujos existente; no lo reemplazan. -
human-gatedpuerta humana
The watching guardrail remains next.La barrera que observa sigue pendiente. Metric, vision, and narrative checks that propose bounded fixes and wait for human approval remain explicitly gated. The project does not claim this phase shipped. Las revisiones métricas, visuales y narrativas que proponen arreglos acotados y esperan aprobación humana siguen bloqueadas de forma explícita. El proyecto no afirma que esta fase esté publicada.
-
andy
Provenance and compositor depth.Procedencia y composición avanzada. Optional C2PA export credentials, revision-to-render lineage, alpha-aware layered compositing, per-layer effect routing, and deterministic rendered-output checks are implemented on the development tip. Las credenciales C2PA opcionales, el linaje de revisión a render, la composición por capas con alfa, los efectos por capa y las comprobaciones deterministas del render están implementados en la punta de desarrollo.
Questions people and agents ask Preguntas de personas y agentes
What is Kinocut?¿Qué es Kinocut?
Kinocut is a free, open-source Model Context Protocol (MCP) server, Python library, and CLI for AI-agent video editing. It wraps FFmpeg and Hyperframes with preflight guardrails, Video Receipts, and quality checkpoints. It was formerly named mcp-video. Kinocut es un servidor MCP, biblioteca Python y CLI de código abierto para edición de video por agentes de IA. Envuelve FFmpeg e Hyperframes con barreras previas, Video Receipts y controles de calidad. Antes se llamaba mcp-video.
How do I install Kinocut?¿Cómo se instala?
Install FFmpeg, then pip install kinocut. For Claude Code: claude mcp add kinocut -- uvx --from kinocut kino. Run kino doctor to verify.
Instala FFmpeg y luego pip install kinocut. En Claude Code: claude mcp add kinocut -- uvx --from kinocut kino. Verifica con kino doctor.
Is Kinocut free and local-first?¿Es gratis y local?
Yes. Apache-2.0, runs on your machine, no Kinocut account or API key required for the core surface, and your media is not uploaded to a Kinocut cloud. Sí. Apache-2.0, corre en tu máquina, sin cuenta ni API key de Kinocut para el núcleo, y tu material no se sube a una nube de Kinocut.
Which AI agents work with Kinocut?¿Qué agentes funcionan?
Any MCP-compatible client that can run a local stdio server — Claude Code, Cursor, Windsurf, Cline, and similar. You can also use the Python client or kino CLI without an agent.
Cualquier cliente MCP con servidor stdio local — Claude Code, Cursor, Windsurf, Cline y similares. También puedes usar el cliente Python o la CLI kino sin un agente.
Kinocut vs raw FFmpeg?¿Kinocut vs FFmpeg puro?
Kinocut exposes typed MCP, CLI, and Python operations with server-side validation, preflight guardrails, structured errors, quality checks, and Video Receipt provenance so agents do not invent brittle FFmpeg flag strings. Kinocut expone operaciones tipadas (MCP, CLI, Python) con validación en servidor, barreras previas, errores estructurados, controles de calidad y procedencia Video Receipt para que los agentes no inventen flags frágiles de FFmpeg.
Can it edit Insta360 / 360 video?¿Puede editar video 360 / Insta360?
Yes — from a stitched equirect MP4, not raw .insv or GoPro .360. video_intent with a 360/desk/table goal writes a reviewable 360_assembly_plan. Approve, then render split / switch / PiP / single. Works for Insta360, Ricoh Theta, GoPro MAX, DJI Osmo 360, and other 2:1 or spherical-tagged exports. No extra MCP tool name.
Sí — desde un MP4 equirectangular ya stitched, no .insv ni GoPro .360. video_intent con un objetivo 360/escritorio/mesa escribe un 360_assembly_plan revisable. Aprueba y renderiza split / switch / PiP / single. Sirve para Insta360, Ricoh Theta, GoPro MAX, DJI Osmo 360 y otros exports 2:1 o con marca esférica. Sin herramienta MCP extra.
Was it called mcp-video?¿Se llamaba mcp-video?
Yes. Kinocut 1.7.0 was the rename; current is 1.15.0. Compatibility entry points, imports, environment variables, and receipt keys remain supported on the 1.14.x line. Sí. Kinocut 1.7.0 fue el renombre; la publicada actual es 1.15.0. Los puntos de compatibilidad, imports, variables de entorno y claves de recibo se mantienen en la línea 1.14.x.