Skip to Content
MCP Documentation

freebeat MCP

freebeat est le plus grand générateur de clips musicaux, et son serveur MCP permet aux agents IA de l’utiliser directement : clips musicaux, vidéos de paroles et vidéos de danse à partir de n’importe quelle chanson, ainsi que l’écriture de chansons, les photos qui chantent, la synchronisation labiale, les images et les clips vidéo.

  • URL du serveur : https://freebeat.ai/api/mcp (distant, Streamable HTTP)
  • Connexion : OAuth avec votre compte freebeat. Pas de clé API.
  • Compatible avec : ChatGPT, Codex, Claude, Claude Code, Cursor et tout agent qui se connecte à des serveurs MCP distants via OAuth.

Connexion

ChatGPT

  1. Settings → Apps → Advanced settings → activez Developer mode.
  2. Plugins → Browse directory → Add → Add custom MCP server. Nommez-le freebeat, URL https://freebeat.ai/api/mcp, authentification OAuth, puis Connect.
  3. Connectez-vous à freebeat et cliquez sur Allow.

Codex (CLI, extension d’IDE et app)

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

Claude (web et bureau)

  1. Customize → Connectors → Add → Add custom connector.
  2. Nom freebeat, URL https://freebeat.ai/api/mcp, puis Add et Connect.
  3. Connectez-vous à freebeat et cliquez sur Allow.

Claude Code

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

Lancez ensuite /mcp dans Claude Code, choisissez freebeat et connectez-vous.

Cursor

Ajouter freebeat à Cursor, ou placez ceci dans ~/.cursor/mcp.json et cliquez sur Connect dans les paramètres MCP de Cursor :

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

Autres agents

Ajoutez un serveur MCP distant avec l’URL https://freebeat.ai/api/mcp. Le serveur publie ses métadonnées OAuth (/.well-known/oauth-protected-resource/api/mcp et /.well-known/oauth-authorization-server) et prend en charge l’enregistrement dynamique de clients avec PKCE ; tout client qui suit la spécification d’autorisation MCP peut donc se connecter.

Crédits

Les vidéos et autres générations utilisent vos crédits freebeat ; les nouveaux comptes reçoivent 500 crédits. Votre agent vous demande avant de dépenser : chaque outil payant accepte max_credits (le maximum que vous autorisez) ou, quand aucun total ne peut être annoncé à l’avance, accept_unknown_cost. Les vidéos musicales, lyrics et de danse sont facturées étape par étape, leur total n’est donc pas connu à l’avance et elles nécessitent accept_unknown_cost. get_credit_balance affiche votre solde et quote_generation chiffre les outils dont le prix peut être annoncé.

Outils

Clip musical, vidéo de paroles et vidéo de danse

OutilCe qu’il fait
generate_music_videoUn clip musical multi-scènes monté sur la chanson. Des photos facultatives (jusqu’à 5) y placent votre artiste ou vos personnages. 720p ou 1080p.
generate_lyric_videoDes paroles animées en synchronisation avec la voix, en 768p ou 2K.
generate_dance_videoLes personnes de vos photos dansent sur la chanson (9:16 ou 3:4, 720p).
get_video_sessionLes messages du réalisateur, l’étape et les médias d’une vidéo en cours.
send_video_agent_messageEnvoyez vos remarques au réalisateur, ou passez la session en mode auto.

Les trois outils vidéo prennent une chanson (music_id issu de upload_audio ou generate_music), un prompt et des photos facultatifs, ainsi que auto_mode : true laisse le réalisateur tout décider, false le fait s’arrêter à chaque étape pour attendre vos remarques (co-création). Par défaut, les 15 premières secondes de la chanson sont utilisées ; définissez start_ms et end_ms pour un autre passage, dans la limite de votre compte. Une vidéo prend généralement de 15 à 60 minutes et s’exécute sur les serveurs de freebeat ; le résultat comprend le lien de la vidéo et sa page sur freebeat.ai.

Musique

OutilCe qu’il fait
list_music_modelsLes modèles de musique que vous pouvez utiliser.
generate_musicUne chanson originale à partir d’un prompt, avec vos paroles si vous en donnez.

Chant et synchronisation labiale

OutilCe qu’il fait
generate_singing_videoUne photo, un animal ou deux personnes (duo) chantent un morceau.
generate_lip_sync_videoSynchronise les lèvres d’un clip vidéo existant avec un audio.

Images, clips vidéo et texte

OutilCe qu’il fait
list_models, get_model_helpLes modèles d’image et de vidéo disponibles et comment utiliser chacun.
generate_image, edit_imageCréer ou modifier des images.
generate_videoUn clip vidéo sans chanson (texte ou image vers vidéo).
generate_textDu texte généré par un modèle de langage.
list_effects, generate_effectDes vidéos à partir de modèles d’effets, avec une chanson et une image.

Entrées, progression et crédits

OutilCe qu’il fait
upload_audioUne chanson issue d’un fichier joint, d’un lien audio HTTPS ou d’une page SoundCloud, YouTube, Suno, Udio, TikTok, Stable Audio ou Riffusion. Renvoie un music_id.
upload_image, upload_videoImages de référence et clips vidéo.
get_task_status, get_task_resultLa progression et le résultat final d’une tâche.
get_credit_balance, quote_generationVotre solde et le prix d’une génération.

Déconnexion

Supprimez freebeat dans les paramètres de connecteurs ou de MCP de votre agent. La déconnexion révoque l’accès de la connexion à votre compte.

Last updated on