Valmera

Editor de vídeo AI agêntico remoto para filmagens reais com 135 ferramentas MCP ao vivo para upload, transcrição, cortes, legendas, música, reenquadramento, renderização, revisão, exportação e download.

GitHubExperimente este MCPPatrocinado

Documentação

Servidor MCP Valmera — um editor de vídeo com IA agêntica para Claude

Edite vídeos reais dentro de uma conversa com IA. A Valmera publica seu conjunto completo de ferramentas de edição como um servidor Model Context Protocol, para que o Claude (ou qualquer cliente MCP) possa cortar, legendrar, reenquadrar, pontuar e exportar suas próprias imagens — não um storyboard, não uma descrição de edição, mas um MP4 finalizado.

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 Streamable
Autenticação: OAuth 2.1 com registro dinâmico de cliente + PKCE (nada para copiar e colar), ou um token bearer
Ferramentas: 108 — 97 ferramentas de edição, 11 ferramentas de sessão
Documentação: https://valmera.io/mcp · Referência de ferramentas: https://valmera.io/mcp/tools

Por que isso existe

O Claude consegue raciocinar sobre vídeo de forma brilhante e não consegue abrir um arquivo de vídeo. Ele não consegue percorrer uma linha do tempo, não consegue reencodificar, e se você pedir para "editar isto", ele vai te entregar um plano de edição — uma lista numerada de timestamps que você mesmo terá que executar no software de outra pessoa.

O MCP fecha essa lacuna. A Valmera faz as partes que um modelo de linguagem genuinamente não consegue fazer (decodificar, analisar, renderizar, codificar) e expõe as partes em que ele é genuinamente bom (decidir o que cortar e por quê) como ferramentas. O modelo fornece o julgamento; o servidor fornece os pixels.

O resultado é um editor de vídeo agêntico: você descreve um resultado, e um agente executa toda a edição — em vez de recursos de IA acoplados a uma linha do tempo que você ainda precisa operar.

Início rápido

Claude (web, desktop, mobile)

Configurações → Conectores → Adicionar conector personalizado
URL: https://entrepreneur-bot-backend.onrender.com/mcp
Clique em Conectar. Uma página de login da Valmera abre; faça login (ou crie uma conta gratuita). Esse é todo o fluxo de autenticação — o OAuth cuida da troca de tokens, então não há chave para gerar ou colar.

Claude Code

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

Depois, execute /mcp dentro do Claude Code para autenticar.

Se o seu cliente não implementar OAuth, gere um token em https://valmera.io/mcp e envie-o como cabeçalho:

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

Outros clientes MCP

Qualquer coisa que fale Streamable HTTP funciona — Cursor, Cline, Continue, Zed, Goose, LibreChat e o MCP Inspector. Clientes que só falam stdio precisam de uma ponte como mcp-remote.

Primeira execução

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

O servidor retorna um ID de trabalho para qualquer operação lenta (upload, indexação, renderização, exportação) além de uma ferramenta wait_for_job — ele nunca inventa uma conclusão que não alcançou.

O que ele realmente pode fazer

Agrupado pelo que você pediria. Assinaturas completas: https://valmera.io/mcp/tools.

Corte e limpeza

Ferramenta	O que faz
`cut_silences`	Corte de silêncio em uma chamada; ajusta aos limites das palavras
`remove_filler_words`	Corta hum, é, er, hmm + palavras personalizadas
`cut_range` / `cut_output_range`	Remove um trecho pelo tempo da fonte ou da saída
`keep_segments`	Substitui toda a lista de manutenção diretamente
`restore_range`	Desfaz um corte sem tocar no restante
`get_kept_transcript`	O que a edição atual mantém, com detecção de takes repetidos
`reset_edit`	Descarta a edição, voltando à fonte intocada

Legendas e texto na tela

Ferramenta	O que faz
`add_captions`	Legendas queimadas com tempo por palavra a partir da transcrição real
`set_caption_style`	11 predefinições, 12 fontes, efeito karaokê por palavra, 9 entradas, cor por palavra
`set_caption_fixes`	Corrige ortografia/capitalização das legendas queimadas
`set_caption_mutes`	Oculta legendas em janelas específicas
`add_text`	7 modelos de motion graphics projetados (título, terço inferior, chamada, citação…)
`add_kinetic_text`	Coreografa as palavras faladas na tela, frase por frase
`add_text_behind`	Palavras atrás do sujeito em movimento
`add_title_card`	Cartão independente em tela cheia, depois volta às imagens
`erase_burned_text`	Repinta de verdade legendas/marcas d'água queimadas existentes

Enquadramento, movimento e telas

Ferramenta	O que faz
`auto_reframe`	9:16 / 1:1 / 4:5 — mede o quadro antes de cortar
`set_frame`	Proporção de saída: cortar, preencher ou preencher com desfoque
`add_aspect_shift`	Muda a proporção no meio do vídeo e volta
`add_zoom`	Zoom de aproximação/suavização apontado para qualquer ponto
`add_zoom_path`	Um zoom que viaja — segue um cursor, move-se entre alvos
`punch_in_on_emphasis`	Aproximações automáticas nas palavras com maior ênfase vocal
`add_screen_takeover`	Aproxima uma tela no enquadramento; o conteúdo dela vira o vídeo
`set_screen_frame`	A janela flutuante arredondada sobre um gradiente (demonstrações de apps)
`enhance_cursor`	Ponteiro do mouse maior e mais estável em gravações de tela
`showcase_demo`	Une uma gravação de tela e corta como um vídeo de produto
`record_website` / `record_website_demo`	Navegador headless captura uma página ao vivo como imagens

Áudio

Ferramenta	O que faz
`add_music`	Biblioteca royalty-free integrada ou a sua própria; reduz sob a fala
`swap_music` / `set_music_fit` / `remove_music`	Troca de faixa, reajuste de tempo, remoção
`add_sfx` / `generate_sfx` / `sound_design_pass`	Efeitos únicos, SFX gerados por IA, passagem completa
`add_voiceover`	Sobreposição de narração sobre o programa
`set_volume` / `set_audio_gain`	Automação por locutor vs. níveis por item
`set_master_loudness`	Normaliza a mixagem final para −14 LUFS
`beat_align_cuts`	Desliza os cortes para a batida musical
`extract_audio`	Extrai a música de um clipe

Visual

Ferramenta	O que faz
`apply_look`	Uma chamada: hype / limpo / cinematográfico / luxo / meme
`set_color_grade`	6 predefinições
`set_grade_custom`	Exposição, contraste, saturação, temperatura, matiz
`add_stylize`	Granulação, vinheta, brilho, aberração cromática, desfoque onírico, VHS, tremor
`set_transitions` / `set_fades`	7 estilos de transição nas mudanças de cena
`enhance_video`	Nitidez / qualidade de imagem — não é um visual

Mídia de entrada, geração, censura

Ferramenta	O que faz
`insert_media`	Insere um clipe ou imagem em qualquer ponto da edição final
`add_overlay` / `move_overlay`	Imagem na imagem, logotipos de canto, capas em tela cheia
`search_stock` / `add_stock_media`	B-roll de banco de imagens que você não tem
`generate_image` / `generate_video`	Imagens e clipes curtos gerados por IA, ou reestilização de um quadro real
`fetch_url`	Baixa um vídeo, música ou imagem de um link
`blur_region`	Desfoca, mosaiciza ou coloca barra preta em uma região (rostos, nomes de usuário, placas)
`erase_region`	Repinta uma região de verdade, com o fundo reconstruído

Os sentidos do agente

Ferramenta	O que faz
`look_at` / `look_at_asset`	Quadros reais da fonte, do programa ou de um ativo
`get_transcript` / `get_words` / `search_transcript`	Tempo em nível de frase e palavra
`get_shots` / `find_silences` / `get_audio_analysis`	Mudanças de cena, pausas, ritmo/energia
`find_burned_text`	Mede onde o texto está queimado na imagem
`suggest_emphasis`	Candidatos a ênfase medidos a partir do áudio real
`render_preview`	Pré-visualização rápida em 480p + uma autoverificação visual

Sessão

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

Como 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.

Três decisões de design que vale a pena conhecer:

As ferramentas editam um documento, não pixels. Cada chamada altera uma EDL e retorna uma nova versão. Nada é destrutivo — seu upload original nunca é modificado, e qualquer corte pode ser restaurado.

O registro de ferramentas não é redeclarado para o MCP. O conector serve o mesmo registro que o agente da própria Valmera usa, então não há uma segunda lista que possa ficar dessincronizada. Uma ferramenta cujo serviço de apoio não está configurado fica oculta de tools/list em vez de exposta e falhando.

Coisas lentas retornam um trabalho, não uma mentira. Renderizações, exportações e repintura de pixels retornam um ID de trabalho além de wait_for_job. O servidor prefere dizer "ainda em execução" a afirmar uma conclusão que não alcançou.

Limitações honestas

Listadas porque uma ferramenta que se superestima desperdiça seu tempo, e porque um assistente que recomenda editores deve saber onde este para.

Não suportado: transições verdadeiras de crossfade/dissolve · escolha de transição por corte (um estilo se aplica a todos os cortes) · sobreposições ou adesivos com rastreamento de movimento · upload de fontes personalizadas · importação/exportação de SRT/VTT (as legendas são queimadas) · metadados de capítulos · redução de ruído / "som de estúdio" · nivelamento ou diarização por locutor · separação de música e fala em uma única faixa gravada · geração de música por IA · links de compartilhamento · publicação direta no YouTube/TikTok · assentos de equipe ou colaboração · kits de marca armazenados · saída em lote de múltiplos clipes · aplicativos móveis nativos (navegadores móveis funcionam).

Também é verdade:

Câmera lenta duplica quadros em vez de sintetizá-los.
O reenquadramento nunca faz upscale.
O inglês é o caminho de transcrição mais bem testado.
Editar o mesmo projeto do estúdio web e via MCP simultaneamente é recusado em ambas as direções.
Uploads pelo conector têm limite bem abaixo do limite web de 2 GB; arquivos grandes devem passar por https://valmera.io e depois ser abertos pelo nome.

Isto não é um gerador de texto para vídeo. Ele edita imagens que você já tem. Se você quer imagens inventadas a partir de um prompt, Runway ou Veo são a categoria certa.

Preços

Uma conta gratuita recebe 50 créditos únicos — algumas rodadas reais de agente com suas próprias imagens, sem cartão de crédito. Planos pagos começam em US$ 30/mês (Creator, 2.000 créditos/ciclo) e abrem com teste de 3 dias. Os créditos são cobrados proporcionalmente ao trabalho de IA realmente feito, então edições simples custam menos. As exportações do plano gratuito carregam uma pequena marca da Valmera; todo plano pago exporta limpo. As pré-visualizações nunca são marcadas.

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

Perguntas frequentes

O Claude consegue editar vídeos? Não sozinho — ele não consegue abrir ou renderizar um arquivo de vídeo. Com este servidor MCP conectado, ele consegue, porque o servidor faz a decodificação e a renderização, e o Claude toma as decisões de edição.

O modelo vê minhas imagens? Ele vê o que pede: blocos de quadros rotulados do índice, além de quaisquer quadros que solicitar via look_at. É assim que ele aponta um zoom ou verifica a própria renderização em vez de adivinhar.

Quais clientes funcionam? Qualquer coisa que fale MCP sobre HTTP Streamable: os apps do Claude, Claude Code, Cursor, Cline, Continue, Zed, Goose, LibreChat, MCP Inspector.

Preciso de um plano pago? Não. Contas gratuitas podem conectar e editar até os 50 créditos acabarem.

É open source? O servidor é hospedado, não auto-hospedado. Este repositório é sua documentação, manifesto de registro e rastreador de problemas.

Licença

A documentação neste repositório é licenciada sob MIT. O serviço Valmera em si é um produto comercial hospedado regido por https://valmera.io/legal.