Skip to Content
MCP Documentation

freebeat MCP

freebeat è il più grande generatore di video musicali, e il suo server MCP permette agli agenti IA di usarlo direttamente: video musicali, video con testi e video di danza da qualsiasi brano, oltre a scrittura di canzoni, foto che cantano, lip sync, immagini e clip video.

  • URL del server: https://freebeat.ai/api/mcp (remoto, Streamable HTTP)
  • Accesso: OAuth con il tuo account freebeat. Nessuna chiave API.
  • Funziona con: ChatGPT, Codex, Claude, Claude Code, Cursor e qualsiasi agente che si collega a server MCP remoti con OAuth.

Collegamento

ChatGPT

  1. Settings → Apps → Advanced settings → attiva Developer mode.
  2. Plugins → Browse directory → Add → Add custom MCP server. Chiamalo freebeat, URL https://freebeat.ai/api/mcp, autenticazione OAuth, poi Connect.
  3. Accedi a freebeat e fai clic su Allow.

Codex (CLI, estensione IDE e app)

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

Claude (web e desktop)

  1. Customize → Connectors → Add → Add custom connector.
  2. Nome freebeat, URL https://freebeat.ai/api/mcp, poi Add e Connect.
  3. Accedi a freebeat e fai clic su Allow.

Claude Code

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

Poi esegui /mcp in Claude Code, scegli freebeat e accedi.

Cursor

Aggiungi freebeat a Cursor, oppure inserisci questo in ~/.cursor/mcp.json e fai clic su Connect nelle impostazioni MCP di Cursor:

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

Altri agenti

Aggiungi un server MCP remoto con l’URL https://freebeat.ai/api/mcp. Il server pubblica i propri metadati OAuth (/.well-known/oauth-protected-resource/api/mcp e /.well-known/oauth-authorization-server) e supporta la registrazione dinamica dei client con PKCE, quindi qualsiasi client che segue la specifica di autorizzazione MCP può accedere.

Crediti

I video e le altre generazioni usano i tuoi crediti freebeat; i nuovi account ricevono 500 crediti. Il tuo agente chiede prima di spendere: ogni strumento a pagamento accetta max_credits (il massimo che autorizzi a spendere) oppure, quando non si può indicare un totale in anticipo, accept_unknown_cost. I video musicali, lyric e di danza vengono addebitati fase per fase, quindi il loro totale non è noto in anticipo e richiedono accept_unknown_cost. get_credit_balance mostra il tuo saldo e quote_generation indica il prezzo degli strumenti per cui si può dare un preventivo.

Strumenti

Video musicale, video con testi e video di danza

StrumentoCosa fa
generate_music_videoUn video musicale multi-scena montato sul brano. Foto facoltative (fino a 5) mettono il tuo artista o i tuoi personaggi nel video. 720p o 1080p.
generate_lyric_videoTesti animati in sincronia con la voce, a 768p o 2K.
generate_dance_videoLe persone nelle tue foto ballano sul brano (9:16 o 3:4, 720p).
get_video_sessionI messaggi del regista, la fase e i contenuti multimediali di un video in corso.
send_video_agent_messageInvia le tue note al regista oppure passa la sessione in automatico.

Tutti e tre gli strumenti video accettano un brano (music_id da upload_audio o generate_music), un prompt e foto facoltativi, e auto_mode: true lascia decidere tutto al regista, false lo fa fermare a ogni fase in attesa delle tue note (co-creazione). Per impostazione predefinita si usano i primi 15 secondi del brano; imposta start_ms e end_ms per un altro passaggio, fino al limite del tuo account. Un video di solito richiede da 15 a 60 minuti e viene eseguito sui server di freebeat; il risultato include il link del video e la sua pagina su freebeat.ai.

Musica

StrumentoCosa fa
list_music_modelsI modelli musicali che puoi usare.
generate_musicUna canzone originale da un prompt, con i tuoi testi se li fornisci.

Canto e lip sync

StrumentoCosa fa
generate_singing_videoUna foto, un animale domestico o due persone (duetto) cantano un brano.
generate_lip_sync_videoSincronizza le labbra di una clip video esistente con l’audio.

Immagini, clip video e testo

StrumentoCosa fa
list_models, get_model_helpI modelli di immagini e video disponibili e come usare ciascuno.
generate_image, edit_imageCrea o modifica immagini.
generate_videoUna clip video senza brano (da testo o da immagine a video).
generate_textTesto da un modello linguistico.
list_effects, generate_effectVideo con modelli di effetti da un brano e un’immagine.

Input, avanzamento e crediti

StrumentoCosa fa
upload_audioUn brano da un file allegato, un link audio HTTPS o una pagina di SoundCloud, YouTube, Suno, Udio, TikTok, Stable Audio o Riffusion. Restituisce un music_id.
upload_image, upload_videoImmagini di riferimento e clip video.
get_task_status, get_task_resultL’avanzamento e il risultato finale di un’attività.
get_credit_balance, quote_generationIl tuo saldo e il prezzo di una generazione.

Scollegamento

Rimuovi freebeat nelle impostazioni dei connettori o di MCP del tuo agente. Scollegando, la connessione perde l’accesso al tuo account.

Last updated on