Skip to Content
MCP Documentation

freebeat MCP

freebeat es el generador de videoclips más grande, y su servidor MCP permite que los agentes de IA lo usen directamente: videoclips, videos de letras y videos de baile a partir de cualquier canción, además de composición de canciones, fotos que cantan, sincronización labial, imágenes y clips de video.

  • URL del servidor: https://freebeat.ai/api/mcp (remoto, Streamable HTTP)
  • Inicio de sesión: OAuth con tu cuenta de freebeat. Sin clave de API.
  • Compatible con: ChatGPT, Codex, Claude, Claude Code, Cursor y cualquier agente que se conecte a servidores MCP remotos con OAuth.

Conectar

ChatGPT

  1. Settings → Apps → Advanced settings → activa Developer mode.
  2. Plugins → Browse directory → Add → Add custom MCP server. Ponle el nombre freebeat, URL https://freebeat.ai/api/mcp, autenticación OAuth y pulsa Connect.
  3. Inicia sesión en freebeat y haz clic en Allow.

Codex (CLI, extensión de IDE y app)

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

Claude (web y escritorio)

  1. Customize → Connectors → Add → Add custom connector.
  2. Nombre freebeat, URL https://freebeat.ai/api/mcp, y luego Add y Connect.
  3. Inicia sesión en freebeat y haz clic en Allow.

Claude Code

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

Después ejecuta /mcp en Claude Code, elige freebeat e inicia sesión.

Cursor

Añadir freebeat a Cursor, o pega esto en ~/.cursor/mcp.json y haz clic en Connect en los ajustes de MCP de Cursor:

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

Otros agentes

Añade un servidor MCP remoto con la URL https://freebeat.ai/api/mcp. El servidor publica sus metadatos OAuth (/.well-known/oauth-protected-resource/api/mcp y /.well-known/oauth-authorization-server) y admite el registro dinámico de clientes con PKCE, así que cualquier cliente que siga la especificación de autorización de MCP puede iniciar sesión.

Créditos

Los videos y otras generaciones consumen tus créditos de freebeat; las cuentas nuevas reciben 500 créditos. Tu agente pregunta antes de gastar: cada herramienta de pago acepta max_credits (lo máximo que permites gastar) o, cuando no se puede dar un total por adelantado, accept_unknown_cost. Los videos musicales, de letras y de baile se cobran etapa por etapa, así que su total no se conoce de antemano y requieren accept_unknown_cost. get_credit_balance muestra tu saldo y quote_generation calcula el precio de las herramientas que se pueden presupuestar.

Herramientas

Videoclip, video de letras y video de baile

HerramientaQué hace
generate_music_videoUn videoclip de varias escenas montado al ritmo de la canción. Con fotos opcionales (hasta 5), tu artista o tus personajes aparecen en él. 720p o 1080p.
generate_lyric_videoLetras animadas sincronizadas con la voz, en 768p o 2K.
generate_dance_videoLas personas de tus fotos bailan al ritmo de la canción (9:16 o 3:4, 720p).
get_video_sessionLos mensajes del director, la etapa y los medios de un video en curso.
send_video_agent_messageEnvía tus notas al director o cambia la sesión a automático.

Las tres herramientas de video aceptan una canción (music_id de upload_audio o generate_music), un prompt y fotos opcionales, y auto_mode: true deja que el director decida todo, false hace que se detenga a esperar tus notas en cada etapa (co-creación). Por defecto se usan los primeros 15 segundos de la canción; define start_ms y end_ms para otro fragmento, hasta el límite de tu cuenta. Un video suele tardar de 15 a 60 minutos y se ejecuta en los servidores de freebeat; el resultado incluye el enlace del video y su página en freebeat.ai.

Música

HerramientaQué hace
list_music_modelsLos modelos de música que puedes usar.
generate_musicUna canción original a partir de un prompt, con tu letra si la das.

Canto y sincronización labial

HerramientaQué hace
generate_singing_videoUna foto, una mascota o dos personas (dúo) cantan una pista.
generate_lip_sync_videoSincroniza los labios de un clip de video existente con un audio.

Imágenes, clips de video y texto

HerramientaQué hace
list_models, get_model_helpLos modelos de imagen y video disponibles y cómo usar cada uno.
generate_image, edit_imageCrea o edita imágenes.
generate_videoUn clip de video sin canción (de texto o imagen a video).
generate_textTexto de un modelo de lenguaje.
list_effects, generate_effectVideos con plantillas de efectos a partir de una canción y una imagen.

Entradas, progreso y créditos

HerramientaQué hace
upload_audioUna canción desde un archivo adjunto, un enlace de audio HTTPS o una página de SoundCloud, YouTube, Suno, Udio, TikTok, Stable Audio o Riffusion. Devuelve un music_id.
upload_image, upload_videoImágenes de referencia y clips de video.
get_task_status, get_task_resultEl progreso y el resultado final de una tarea.
get_credit_balance, quote_generationTu saldo y el precio de una generación.

Desconectar

Elimina freebeat en los ajustes de conectores o de MCP de tu agente. Al desconectar, la conexión pierde el acceso a tu cuenta.

Last updated on