Skip to Content
MCP Documentation

freebeat MCP

freebeat is the biggest music video generator, and its MCP server lets AI agents use it directly: music videos, lyric videos and dance videos from any song, plus song writing, singing photos, lip sync, images and video clips.

  • Server URL: https://freebeat.ai/api/mcp (remote, Streamable HTTP)
  • Sign-in: OAuth with your freebeat account. No API key.
  • Works with: ChatGPT, Codex, Claude, Claude Code, Cursor and any agent that connects to remote MCP servers with OAuth.

Connect

ChatGPT

  1. Settings → Apps → Advanced settings → turn on Developer mode.
  2. Plugins → Browse directory → Add → Add custom MCP server. Name it freebeat, URL https://freebeat.ai/api/mcp, authentication OAuth, then Connect.
  3. Sign in to freebeat and click Allow.

Codex (CLI, IDE extension and app)

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

Claude (web and desktop)

  1. Customize → Connectors → Add → Add custom connector.
  2. Name freebeat, URL https://freebeat.ai/api/mcp, then Add and Connect.
  3. Sign in to freebeat and click Allow.

Claude Code

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

Then run /mcp in Claude Code, pick freebeat and sign in.

Cursor

Add freebeat to Cursor, or put this in ~/.cursor/mcp.json and click Connect in Cursor’s MCP settings:

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

Other agents

Add a remote MCP server with the URL https://freebeat.ai/api/mcp. The server publishes its OAuth metadata (/.well-known/oauth-protected-resource/api/mcp and /.well-known/oauth-authorization-server) and supports dynamic client registration with PKCE, so any client that follows the MCP authorization spec can sign in.

Credits

Videos and other generations use your freebeat credits; new accounts get 500 credits. Your agent asks before spending: every paid tool takes max_credits (the most you allow it to spend) or, when no total can be quoted in advance, accept_unknown_cost. Music, lyric and dance videos are charged stage by stage, so their total is not known up front and they need accept_unknown_cost. get_credit_balance shows your balance and quote_generation prices the tools that can be quoted.

Tools

Music video, lyric video and dance video

ToolWhat it does
generate_music_videoA multi-scene music video cut to the song. Optional photos (up to 5) put your artist or characters in it. 720p or 1080p.
generate_lyric_videoAnimated lyrics in sync with the vocals, at 768p or 2K.
generate_dance_videoThe people in your photos dance to the song (9:16 or 3:4, 720p).
get_video_sessionThe director’s messages, stage and media for a running video.
send_video_agent_messageSend your notes to the director, or switch the session to auto.

All three video tools take a song (music_id from upload_audio or generate_music), an optional prompt and photos, and auto_mode: true lets the director decide everything, false makes it pause for your notes at each stage (co-create). By default the first 15 seconds of the song are used; set start_ms and end_ms for another part, up to your account’s limit. A video usually takes 15 to 60 minutes and runs on freebeat’s servers; the result includes the video link and its page on freebeat.ai.

Music

ToolWhat it does
list_music_modelsThe music models you can use.
generate_musicAn original song from a prompt, with your lyrics if you give them.

Singing and lip sync

ToolWhat it does
generate_singing_videoA photo, a pet or two people (duet) sing a track.
generate_lip_sync_videoLip-syncs an existing video clip to audio.

Images, video clips and text

ToolWhat it does
list_models, get_model_helpThe image and video models available and how to use each.
generate_image, edit_imageCreate or edit images.
generate_videoA video clip without a song (text or image to video).
generate_textText from a language model.
list_effects, generate_effectEffect-template videos from a song and one image.

Inputs, progress and credits

ToolWhat it does
upload_audioA song from an attached file, an HTTPS audio link, or a SoundCloud, YouTube, Suno, Udio, TikTok, Stable Audio or Riffusion page. Returns a music_id.
upload_image, upload_videoReference images and video clips.
get_task_status, get_task_resultProgress and the finished result of a task.
get_credit_balance, quote_generationYour balance and the price of a generation.

Disconnect

Remove freebeat in your agent’s connector or MCP settings. Disconnecting revokes the connection’s access to your account.

Last updated on