Valmera

Editor de video AI agéntico remoto para metraje real con 135 herramientas MCP en vivo para carga, transcripción, cortes, subtítulos, música, reencuadre, renderizado, revisión, exportación y descarga.

Documentación

Servidor MCP de Valmera: un editor de video con IA agéntico para Claude

Edita video real desde una conversación con IA. Valmera publica su conjunto completo de herramientas de edición como un servidor de Model Context Protocol, para que Claude (o cualquier cliente MCP) pueda cortar, subtitular, reencuadrar, musicalizar y exportar tu metraje real — no un guion gráfico, no una descripción de una edición, sino un MP4 terminado.

You:    Cut the dead air, drop the ums, caption it, make it vertical for TikTok.
Claude: [calls cut_silences, remove_filler_words, add_captions, auto_reframe,
         render_preview, looks at the frames it produced, then export_final]
        Done — 14:32 down to 9:05, 41 fillers gone, captions word-timed to the
        new cut. Here's the file.
  • Endpoint: https://entrepreneur-bot-backend.onrender.com/mcp
  • Transporte: HTTP transmisible
  • Autenticación: OAuth 2.1 con registro dinámico de clientes + PKCE (nada que copiar y pegar), o un token de portador
  • Herramientas: 108 — 97 herramientas de edición, 11 herramientas de sesión
  • Documentación: https://valmera.io/mcp · Referencia de herramientas: https://valmera.io/mcp/tools

Por qué existe esto

Claude puede razonar brillantemente sobre video y no puede abrir un archivo de video. No puede recorrer una línea de tiempo, no puede re-codificar, y si le pides que "edite esto" te dará un plan de edición — una lista numerada de marcas de tiempo que luego debes ejecutar tú mismo en el software de otra persona.

MCP cierra esa brecha. Valmera hace las partes que un modelo de lenguaje realmente no puede hacer (decodificar, analizar, renderizar, codificar) y expone las partes en las que es genuinamente bueno (decidir qué cortar y por qué) como herramientas. El modelo aporta el criterio; el servidor aporta los píxeles.

El resultado es un editor de video agéntico: describes un resultado y un agente realiza toda la edición — en lugar de funciones de IA añadidas a una línea de tiempo que aún debes manejar tú.


Inicio rápido

Claude (web, escritorio, móvil)

  1. Configuración → Conectores → Agregar conector personalizado
  2. URL: https://entrepreneur-bot-backend.onrender.com/mcp
  3. Haz clic en Conectar. Se abre una página de inicio de sesión de Valmera; inicia sesión (o crea una cuenta gratuita). Ese es todo el flujo de autenticación: OAuth maneja el intercambio de tokens, así que no hay clave que generar o pegar.

Claude Code

claude mcp add --transport http valmera https://entrepreneur-bot-backend.onrender.com/mcp

Luego ejecuta /mcp dentro de Claude Code para autenticarte.

Si tu cliente no implementa OAuth, genera un token en https://valmera.io/mcp y envíalo como encabezado:

claude mcp add --transport http valmera https://entrepreneur-bot-backend.onrender.com/mcp \
  --header "Authorization: Bearer vlm_mcp_..."

Otros clientes MCP

Cualquier cosa que hable HTTP transmisible funciona: Cursor, Cline, Continue, Zed, Goose, LibreChat y MCP Inspector. Los clientes que solo hablan stdio necesitan un puente como mcp-remote.

Primera ejecución

Create a Valmera project, upload ~/Desktop/podcast.mp4, and once it's indexed
tell me how long it is and what's in it.

El servidor devuelve un id de trabajo para cualquier operación lenta (subida, indexación, renderizado, exportación) además de una herramienta wait_for_job — nunca inventa una finalización que no ha alcanzado.


Lo que realmente puede hacer

Agrupado por lo que pedirías. Firmas completas: https://valmera.io/mcp/tools.

Corte y limpieza

HerramientaQué hace
cut_silencesRecorte de silencios en una llamada; se ajusta a los límites de palabras
remove_filler_wordsCorta "um", "eh", "er", "hmm" + palabras personalizadas
cut_range / cut_output_rangeElimina un segmento por tiempo de origen o salida
keep_segmentsReemplaza toda la lista de conservación directamente
restore_rangeDeshace un corte sin tocar el resto
get_kept_transcriptLo que conserva la edición actual, con detección de tomas repetidas
reset_editDescarta la edición y vuelve al material original sin tocar

Subtítulos y texto en pantalla

HerramientaQué hace
add_captionsSubtítulos quemados con sincronización de palabras desde la transcripción real
set_caption_style11 ajustes preestablecidos, 12 fuentes, efecto karaoke palabra a palabra, 9 entradas, color por palabra
set_caption_fixesCorrige ortografía/mayúsculas de subtítulos quemados
set_caption_mutesOculta subtítulos en ventanas específicas
add_text7 plantillas de gráficos animados diseñadas (título, tercio inferior, llamada, cita…)
add_kinetic_textCoreografía las palabras habladas en pantalla, frase por frase
add_text_behindPalabras detrás del sujeto en movimiento
add_title_cardTarjeta independiente a pantalla completa, luego vuelve al metraje
erase_burned_textRepinta de verdad los subtítulos/marcas de agua quemados existentes

Encuadre, movimiento y pantallas

HerramientaQué hace
auto_reframe9:16 / 1:1 / 4:5 — mide el encuadre antes de recortar
set_frameRelación de aspecto de salida: recorte, relleno o relleno desenfocado
add_aspect_shiftCambia la relación de aspecto a mitad del video y vuelve
add_zoomZoom de acercamiento/suavizado dirigido a cualquier punto
add_zoom_pathUn zoom que viaja — sigue un cursor, se mueve entre objetivos
punch_in_on_emphasisAcercamientos automáticos en las palabras con mayor estrés vocal
add_screen_takeoverAcércate a una pantalla en la toma; su contenido se convierte en el video
set_screen_frameLa ventana flotante redondeada sobre un degradado (demostraciones de apps)
enhance_cursorPuntero del mouse más grande y estable en grabaciones de pantalla
showcase_demoUne una grabación de pantalla y córtala como un video de producto
record_website / record_website_demoEl navegador sin interfaz captura una página en vivo como metraje

Audio

HerramientaQué hace
add_musicBiblioteca libre de regalías integrada o la tuya propia; baja el volumen bajo el habla
swap_music / set_music_fit / remove_musicCambia pista, reajusta tiempo, elimina
add_sfx / generate_sfx / sound_design_passEfectos únicos, SFX generados por IA, pasada completa
add_voiceoverSuperpone narración sobre el programa
set_volume / set_audio_gainAutomatización por hablante vs. niveles por elemento
set_master_loudnessNormaliza la mezcla final a −14 LUFS
beat_align_cutsDesliza los cortes al ritmo musical
extract_audioExtrae la canción de un clip

Apariencia

HerramientaQué hace
apply_lookUna llamada: hype / limpio / cinematográfico / lujo / meme
set_color_grade6 ajustes preestablecidos
set_grade_customExposición, contraste, saturación, temperatura, tinte
add_stylizeGrano, viñeta, brillo, aberración cromática, desenfoque de ensueño, VHS, sacudida
set_transitions / set_fades7 estilos de transición en cambios de escena
enhance_videoNitidez / calidad de imagen — no es una apariencia

Inserción de medios, generación, censura

HerramientaQué hace
insert_mediaInserta un clip o imagen en cualquier parte de la edición final
add_overlay / move_overlayImagen en imagen, logotipos en esquinas, portadas a pantalla completa
search_stock / add_stock_mediaMetraje de archivo que no tienes
generate_image / generate_videoImágenes fijas y clips cortos con IA, o reestiliza un fotograma real
fetch_urlExtrae un video, canción o imagen de un enlace
blur_regionDesenfoca, mosaico o barra negra en una región (rostros, nombres de usuario, placas)
erase_regionRepinta de verdad una región, fondo reconstruido

Los sentidos del agente

HerramientaQué hace
look_at / look_at_assetFotogramas reales de la fuente, el programa o un recurso
get_transcript / get_words / search_transcriptSincronización a nivel de oración y palabra
get_shots / find_silences / get_audio_analysisCambios de escena, pausas, tempo/energía
find_burned_textMide dónde está quemado el texto en la imagen
suggest_emphasisCandidatos de estrés medidos desde el audio real
render_previewVista previa rápida en 480p + autoverificación visual

Sesión

list_projects · open_project · create_project · project_state · upload_start · upload_finish · index_status · export_final · wait_for_job · download_url · watch_video


Cómo funciona

  Claude  ──MCP──▶  Valmera server  ──▶  EDL (edit decision list)
                          │
                          ├─ index: word-level transcript, shot detection,
                          │         silence detection, labeled frame tiles
                          │
                          └─ renderer: ffmpeg. Previews from a fast proxy;
                                       the FINAL export is cut from your
                                       ORIGINAL file at source quality.

Tres decisiones de diseño que vale la pena conocer:

Las herramientas editan un documento, no píxeles. Cada llamada muta una EDL y devuelve una nueva versión. Nada es destructivo: tu subida original nunca se modifica y cualquier corte se puede restaurar.

El registro de herramientas no se vuelve a declarar para MCP. El conector sirve el mismo registro que usa el propio agente de Valmera, por lo que no hay una segunda lista que pueda desincronizarse. Una herramienta cuyo servicio subyacente no está configurado se oculta de tools/list en lugar de exponerse y fallar.

Las cosas lentas devuelven un trabajo, no una mentira. Los renderizados, exportaciones y repintado de píxeles devuelven un id de trabajo más wait_for_job. El servidor prefiere decir "aún en ejecución" que afirmar una finalización que no ha alcanzado.


Límites honestos

Se enumeran porque una herramienta que se sobrevende te hace perder tiempo y porque un asistente que recomienda editores debería saber dónde se detiene este.

No compatible: transiciones reales de fundido/disolución · elección de transición por corte (un estilo se aplica a todos los cortes) · superposiciones o pegatinas con seguimiento de movimiento · subida de fuentes personalizadas · importación/exportación SRT/VTT (los subtítulos se queman) · metadatos de capítulos · reducción de ruido / "sonido de estudio" · nivelación o diarización por hablante · separación de música del habla en una sola pista horneada · generación de música con IA · enlaces para compartir · publicación directa en YouTube/TikTok · asientos de equipo o colaboración · kits de marca almacenados · salida por lotes de múltiples clips · aplicaciones móviles nativas (los navegadores móviles funcionan).

También es cierto:

  • La cámara lenta duplica fotogramas en lugar de sintetizarlos.
  • El reencuadre nunca aumenta la resolución.
  • El inglés es la ruta de transcripción mejor probada.
  • Editar el mismo proyecto desde el estudio web y a través de MCP simultáneamente se rechaza en ambas direcciones.
  • Las subidas a través del conector están limitadas muy por debajo del límite web de 2 GB; los archivos grandes deben pasar por https://valmera.io y luego abrirse por nombre.

Esto no es un generador de texto a video. Edita metraje que ya tienes. Si quieres metraje inventado a partir de un mensaje, Runway o Veo son la categoría correcta.


Precios

Una cuenta gratuita obtiene 50 créditos únicos: algunas vueltas reales de agente en tu propio metraje, sin tarjeta de crédito. Los planes de pago comienzan en $30/mes (Creator, 2,000 créditos/ciclo) y se abren con una prueba de 3 días. Los créditos se cobran en proporción al trabajo de IA realmente realizado, por lo que las ediciones simples cuestan menos. Las exportaciones del plan gratuito llevan una pequeña marca de Valmera; cada plan de pago exporta limpio. Las vistas previas nunca se marcan.

Números actuales: https://valmera.io/subscribe


Preguntas frecuentes

¿Puede Claude editar videos? No por sí solo: no puede abrir ni renderizar un archivo de video. Con este servidor MCP conectado puede, porque el servidor hace la decodificación y el renderizado, y Claude toma las decisiones de edición.

¿El modelo ve mi metraje? Ve lo que pide: mosaicos de fotogramas etiquetados del índice, más cualquier fotograma que solicite a través de look_at. Así es como apunta un zoom o verifica su propio renderizado en lugar de adivinar.

¿Qué clientes funcionan? Cualquier cosa que hable MCP sobre HTTP transmisible: las apps de Claude, Claude Code, Cursor, Cline, Continue, Zed, Goose, LibreChat, MCP Inspector.

¿Necesito un plan de pago? No. Las cuentas gratuitas pueden conectarse y editar hasta que se agoten los 50 créditos.

¿Es de código abierto? El servidor está alojado, no es autoalojado. Este repositorio es su documentación, manifiesto de registro y rastreador de problemas.


Enlaces

Problemas y solicitudes de herramientas: abre un problema aquí.

Licencia

La documentación de este repositorio tiene licencia MIT. El servicio de Valmera en sí es un producto comercial alojado regido por https://valmera.io/legal.