Skip to Content
MCP Documentation

freebeat MCP

freebeat ist der größte Musikvideo-Generator, und sein MCP-Server lässt KI-Agenten ihn direkt nutzen: Musikvideos, Lyric-Videos und Tanzvideos aus jedem Song, dazu Songwriting, singende Fotos, Lippensynchronisation, Bilder und Videoclips.

  • Server-URL: https://freebeat.ai/api/mcp (remote, Streamable HTTP)
  • Anmeldung: OAuth mit deinem freebeat-Konto. Kein API-Schlüssel.
  • Funktioniert mit: ChatGPT, Codex, Claude, Claude Code, Cursor und jedem Agenten, der sich per OAuth mit Remote-MCP-Servern verbindet.

Verbinden

ChatGPT

  1. Settings → Apps → Advanced settings → Developer mode aktivieren.
  2. Plugins → Browse directory → Add → Add custom MCP server. Nenne ihn freebeat, URL https://freebeat.ai/api/mcp, Authentifizierung OAuth, dann Connect.
  3. Melde dich bei freebeat an und klicke auf Allow.

Codex (CLI, IDE-Erweiterung und App)

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

Claude (Web und Desktop)

  1. Customize → Connectors → Add → Add custom connector.
  2. Name freebeat, URL https://freebeat.ai/api/mcp, dann Add und Connect.
  3. Melde dich bei freebeat an und klicke auf Allow.

Claude Code

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

Führe danach /mcp in Claude Code aus, wähle freebeat und melde dich an.

Cursor

freebeat zu Cursor hinzufügen oder trage Folgendes in ~/.cursor/mcp.json ein und klicke in den MCP-Einstellungen von Cursor auf Connect:

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

Weitere Agenten

Füge einen Remote-MCP-Server mit der URL https://freebeat.ai/api/mcp hinzu. Der Server veröffentlicht seine OAuth-Metadaten (/.well-known/oauth-protected-resource/api/mcp und /.well-known/oauth-authorization-server) und unterstützt dynamische Client-Registrierung mit PKCE, sodass sich jeder Client anmelden kann, der die MCP-Autorisierungsspezifikation befolgt.

Credits

Videos und andere Generierungen verbrauchen deine freebeat-Credits; neue Konten erhalten 500 Credits. Dein Agent fragt, bevor er etwas ausgibt: Jedes kostenpflichtige Tool nimmt max_credits (das Maximum, das du freigibst) oder, wenn sich vorab keine Gesamtsumme nennen lässt, accept_unknown_cost. Musik-, Lyric- und Tanzvideos werden Stufe für Stufe abgerechnet, ihre Gesamtsumme ist daher vorab nicht bekannt, und sie brauchen accept_unknown_cost. get_credit_balance zeigt dein Guthaben und quote_generation nennt den Preis für die Tools, die sich vorab beziffern lassen.

Tools

Musikvideo, Lyric-Video und Tanzvideo

ToolWas es tut
generate_music_videoEin Musikvideo mit mehreren Szenen, geschnitten auf den Song. Optionale Fotos (bis zu 5) bringen deine Künstler oder Figuren hinein. 720p oder 1080p.
generate_lyric_videoAnimierte Lyrics synchron zum Gesang, in 768p oder 2K.
generate_dance_videoDie Personen auf deinen Fotos tanzen zum Song (9:16 oder 3:4, 720p).
get_video_sessionDie Nachrichten des Regisseurs, Phase und Medien eines laufenden Videos.
send_video_agent_messageSende deine Anmerkungen an den Regisseur oder stelle die Sitzung auf Auto um.

Alle drei Video-Tools nehmen einen Song (music_id von upload_audio oder generate_music), einen optionalen Prompt und Fotos sowie auto_mode: true lässt den Regisseur alles entscheiden, false lässt ihn in jeder Phase auf deine Anmerkungen warten (Co-Creation). Standardmäßig werden die ersten 15 Sekunden des Songs verwendet; setze start_ms und end_ms für einen anderen Abschnitt, bis zum Limit deines Kontos. Ein Video dauert meist 15 bis 60 Minuten und läuft auf den Servern von freebeat; das Ergebnis enthält den Videolink und die zugehörige Seite auf freebeat.ai.

Musik

ToolWas es tut
list_music_modelsDie Musikmodelle, die du nutzen kannst.
generate_musicEin Original-Song aus einem Prompt, mit deinen Lyrics, wenn du welche angibst.

Gesang und Lippensynchronisation

ToolWas es tut
generate_singing_videoEin Foto, ein Haustier oder zwei Personen (Duett) singen einen Track.
generate_lip_sync_videoSynchronisiert einen vorhandenen Videoclip lippensynchron mit Audio.

Bilder, Videoclips und Text

ToolWas es tut
list_models, get_model_helpDie verfügbaren Bild- und Videomodelle und wie du sie nutzt.
generate_image, edit_imageBilder erstellen oder bearbeiten.
generate_videoEin Videoclip ohne Song (Text- oder Bild-zu-Video).
generate_textText von einem Sprachmodell.
list_effects, generate_effectEffekt-Vorlagen-Videos aus einem Song und einem Bild.

Eingaben, Fortschritt und Credits

ToolWas es tut
upload_audioEin Song aus einer angehängten Datei, einem HTTPS-Audiolink oder einer Seite von SoundCloud, YouTube, Suno, Udio, TikTok, Stable Audio oder Riffusion. Gibt eine music_id zurück.
upload_image, upload_videoReferenzbilder und Videoclips.
get_task_status, get_task_resultFortschritt und fertiges Ergebnis einer Aufgabe.
get_credit_balance, quote_generationDein Guthaben und der Preis einer Generierung.

Trennen

Entferne freebeat in den Connector- oder MCP-Einstellungen deines Agenten. Beim Trennen verliert die Verbindung den Zugriff auf dein Konto.

Last updated on