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
- Settings → Apps → Advanced settings → turn on Developer mode.
- Plugins → Browse directory → Add → Add custom MCP server. Name it
freebeat, URLhttps://freebeat.ai/api/mcp, authentication OAuth, then Connect. - 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 freebeatClaude (web and desktop)
- Customize → Connectors → Add → Add custom connector.
- Name
freebeat, URLhttps://freebeat.ai/api/mcp, then Add and Connect. - Sign in to freebeat and click Allow.
Claude Code
claude mcp add --transport http freebeat https://freebeat.ai/api/mcpThen 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
| Tool | What it does |
|---|---|
generate_music_video | A 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_video | Animated lyrics in sync with the vocals, at 768p or 2K. |
generate_dance_video | The people in your photos dance to the song (9:16 or 3:4, 720p). |
get_video_session | The director’s messages, stage and media for a running video. |
send_video_agent_message | Send 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
| Tool | What it does |
|---|---|
list_music_models | The music models you can use. |
generate_music | An original song from a prompt, with your lyrics if you give them. |
Singing and lip sync
| Tool | What it does |
|---|---|
generate_singing_video | A photo, a pet or two people (duet) sing a track. |
generate_lip_sync_video | Lip-syncs an existing video clip to audio. |
Images, video clips and text
| Tool | What it does |
|---|---|
list_models, get_model_help | The image and video models available and how to use each. |
generate_image, edit_image | Create or edit images. |
generate_video | A video clip without a song (text or image to video). |
generate_text | Text from a language model. |
list_effects, generate_effect | Effect-template videos from a song and one image. |
Inputs, progress and credits
| Tool | What it does |
|---|---|
upload_audio | A 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_video | Reference images and video clips. |
get_task_status, get_task_result | Progress and the finished result of a task. |
get_credit_balance, quote_generation | Your 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.