Skip to Content
MCP Documentation

freebeat MCP

O freebeat é o maior gerador de videoclipes, e o servidor MCP dele permite que agentes de IA o usem diretamente: videoclipes, vídeos de letra e vídeos de dança a partir de qualquer música, além de composição de músicas, fotos que cantam, sincronização labial, imagens e clipes de vídeo.

  • URL do servidor: https://freebeat.ai/api/mcp (remoto, Streamable HTTP)
  • Login: OAuth com sua conta freebeat. Sem chave de API.
  • Funciona com: ChatGPT, Codex, Claude, Claude Code, Cursor e qualquer agente que se conecte a servidores MCP remotos com OAuth.

Conectar

ChatGPT

  1. Settings → Apps → Advanced settings → ative Developer mode.
  2. Plugins → Browse directory → Add → Add custom MCP server. Dê o nome freebeat, URL https://freebeat.ai/api/mcp, autenticação OAuth e clique em Connect.
  3. Faça login no freebeat e clique em Allow.

Codex (CLI, extensão de IDE e app)

codex mcp add freebeat --url https://freebeat.ai/api/mcp codex mcp login freebeat

Claude (web e desktop)

  1. Customize → Connectors → Add → Add custom connector.
  2. Nome freebeat, URL https://freebeat.ai/api/mcp, depois Add e Connect.
  3. Faça login no freebeat e clique em Allow.

Claude Code

claude mcp add --transport http freebeat https://freebeat.ai/api/mcp

Depois execute /mcp no Claude Code, escolha freebeat e faça login.

Cursor

Adicionar o freebeat ao Cursor, ou coloque isto em ~/.cursor/mcp.json e clique em Connect nas configurações de MCP do Cursor:

{ "mcpServers": { "freebeat": { "url": "https://freebeat.ai/api/mcp" } } }

Outros agentes

Adicione um servidor MCP remoto com a URL https://freebeat.ai/api/mcp. O servidor publica seus metadados OAuth (/.well-known/oauth-protected-resource/api/mcp e /.well-known/oauth-authorization-server) e oferece suporte ao registro dinâmico de clientes com PKCE, então qualquer cliente que siga a especificação de autorização do MCP consegue fazer login.

Créditos

Vídeos e outras gerações usam seus créditos do freebeat; contas novas recebem 500 créditos. Seu agente pergunta antes de gastar: toda ferramenta paga aceita max_credits (o máximo que você permite gastar) ou, quando não dá para informar um total antes, accept_unknown_cost. Vídeos musicais, de letra e de dança são cobrados etapa por etapa, então o total deles não é conhecido de antemão e exigem accept_unknown_cost. get_credit_balance mostra seu saldo e quote_generation informa o preço das ferramentas que podem ser cotadas.

Ferramentas

Videoclipe, vídeo de letra e vídeo de dança

FerramentaO que faz
generate_music_videoUm videoclipe com várias cenas, editado no ritmo da música. Fotos opcionais (até 5) colocam seu artista ou seus personagens nele. 720p ou 1080p.
generate_lyric_videoLetras animadas em sincronia com os vocais, em 768p ou 2K.
generate_dance_videoAs pessoas das suas fotos dançam ao som da música (9:16 ou 3:4, 720p).
get_video_sessionAs mensagens do diretor, a etapa e a mídia de um vídeo em andamento.
send_video_agent_messageEnvie suas anotações ao diretor ou mude a sessão para automático.

As três ferramentas de vídeo aceitam uma música (music_id de upload_audio ou generate_music), um prompt e fotos opcionais, e auto_mode: true deixa o diretor decidir tudo, false faz com que ele pare a cada etapa para esperar suas anotações (cocriação). Por padrão, os primeiros 15 segundos da música são usados; defina start_ms e end_ms para outro trecho, até o limite da sua conta. Um vídeo costuma levar de 15 a 60 minutos e roda nos servidores do freebeat; o resultado inclui o link do vídeo e a página dele no freebeat.ai.

Música

FerramentaO que faz
list_music_modelsOs modelos de música que você pode usar.
generate_musicUma música original a partir de um prompt, com a sua letra se você a fornecer.

Canto e sincronização labial

FerramentaO que faz
generate_singing_videoUma foto, um pet ou duas pessoas (dueto) cantam uma faixa.
generate_lip_sync_videoSincroniza os lábios de um clipe de vídeo existente com um áudio.

Imagens, clipes de vídeo e texto

FerramentaO que faz
list_models, get_model_helpOs modelos de imagem e vídeo disponíveis e como usar cada um.
generate_image, edit_imageCria ou edita imagens.
generate_videoUm clipe de vídeo sem música (de texto ou imagem para vídeo).
generate_textTexto de um modelo de linguagem.
list_effects, generate_effectVídeos com modelos de efeito a partir de uma música e uma imagem.

Entradas, progresso e créditos

FerramentaO que faz
upload_audioUma música de um arquivo anexado, de um link de áudio HTTPS ou de uma página do SoundCloud, YouTube, Suno, Udio, TikTok, Stable Audio ou Riffusion. Retorna um music_id.
upload_image, upload_videoImagens de referência e clipes de vídeo.
get_task_status, get_task_resultO progresso e o resultado final de uma tarefa.
get_credit_balance, quote_generationSeu saldo e o preço de uma geração.

Desconectar

Remova o freebeat nas configurações de conectores ou de MCP do seu agente. Ao desconectar, a conexão perde o acesso à sua conta.

Last updated on