Flow Music MCP Server by useapi.net

Google Flow Music (Lyria): músicas, letras, estender, cover, remix, efeitos, stems. De terceiros, pago (US$ 15/mês), roda na sua própria conta do Flow Music.

Ver em useapi.net

Servidor MCP hospedado

npx add-mcp 'https://api.useapi.net/v1/flowmusic/mcp'

Instala no Claude Code, Codex, Cursor e outros

Documentação

Servidor MCP Flow Music

16 de outubro de 2026

O servidor MCP Flow Music da useapi.net permite que um assistente de IA, como Claude Code, Cursor ou VS Code Copilot, crie música com o Google Flow Music nas suas próprias contas do Flow Music. É um servidor hospedado do Model Context Protocol com 18 ferramentas: gere músicas com os modelos Lyria do Google a partir de uma descrição, suas próprias letras ou letras escritas pelo modelo; depois, estenda-as, regenere uma seção, reestilize-as, regrave-as com novas letras, aplique efeitos de áudio ou divida-as em faixas. Cada ferramenta chama a API FlowMusic, então as mesmas regras e limites se aplicam. Nada precisa ser instalado ou hospedado.

Existe um servidor MCP do Flow Music? Sim. A useapi.net, um serviço de terceiros não afiliado ao Google, hospeda um em https://api.useapi.net/v1/flowmusic/mcp com 18 ferramentas para músicas Lyria, covers, remixes e faixas, na sua própria conta do Flow Music, sem necessidade de instalação.

Prefere REST? Tutorial: Como gerar música com IA usando Lyria 3 Pro via API Flow Music · Código: github.com/useapi/flowmusic-api

Veja todos os servidores MCP da useapi.net em Model Matrix & MCP.

Endpoint e autorização

https://api.useapi.net/v1/flowmusic/mcp

Transporte: HTTP Streamable.
Listado no registro oficial do MCP como net.useapi/flowmusic, então clientes e diretórios MCP que leem o registro podem encontrá-lo por esse nome.
Autorização: seu token de API da useapi.net no cabeçalho Authorization: Bearer …, veja Configurar useapi.net.
Você precisa de pelo menos uma conta do Flow Music adicionada com Configurar Flow Music. Adicionar e remover contas não está disponível via MCP: use POST /accounts ou a página de configuração.

Configuração

Substitua YOUR_API_TOKEN pelo seu token de API da useapi.net.

Claude Code

claude mcp add --transport http useapi-flowmusic https://api.useapi.net/v1/flowmusic/mcp --header "Authorization: Bearer YOUR_API_TOKEN"

Cursor

Em ~/.cursor/mcp.json:

{
  "mcpServers": {
    "useapi-flowmusic": {
      "url": "https://api.useapi.net/v1/flowmusic/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_TOKEN"
      }
    }
  }
}

VS Code

Em .vscode/mcp.json:

{
  "servers": {
    "useapi-flowmusic": {
      "type": "http",
      "url": "https://api.useapi.net/v1/flowmusic/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_TOKEN"
      }
    }
  }
}

Windsurf e outros clientes

Qualquer cliente que suporte servidores MCP remotos via HTTP com cabeçalhos personalizados funciona. O formato JSON usual:

{
  "mcpServers": {
    "useapi-flowmusic": {
      "serverUrl": "https://api.useapi.net/v1/flowmusic/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_TOKEN"
      }
    }
  }
}

Alguns clientes nomeiam o campo de endereço como url em vez de serverUrl.

Teste com curl

curl -s https://api.useapi.net/v1/flowmusic/mcp \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2025-06-18","capabilities":{},"clientInfo":{"name":"curl","version":"1"}}}'

curl -s https://api.useapi.net/v1/flowmusic/mcp \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":2,"method":"tools/list"}'

A primeira chamada responde com o nome do servidor useapi-flowmusic e suas instruções para o assistente; a segunda, com as 18 ferramentas.

Ferramentas

Músicas, clipes e arquivos enviados são nomeados pelos ids que as ferramentas retornam, e cada id carrega sua conta, então uma edição é executada na conta que possui o clipe. Ferramentas que iniciam uma música aceitam um email opcional para escolher a conta.

Contas

Ferramenta	O que faz	Parâmetros principais
`flowmusic_list_accounts`	Lista suas contas com plano, `maxJobs` e status.
`flowmusic_get_account`	Lê uma conta em tempo real: plano, créditos e tokens restantes.	`email`
`flowmusic_update_account`	Define `maxJobs`, as músicas e edições que uma conta executa por vez.	`email`, `maxJobs`
`flowmusic_get_usage`	Retorna o uso de créditos de uma conta: eventos de cobrança diários e o custo de cada música.	`email`

Músicas e letras

Ferramenta	O que faz	Parâmetros principais
`flowmusic_create_song`	Gera uma música a partir de uma descrição do estilo, clima, instrumentos e vocais, com suas próprias letras, letras escritas pelo modelo ou instrumental.	`prompt`, `lyrics`, `instrumental`, `ghostwriter`, `model`, `refImage1`..`10`, `refAudio1`..`10`, `email`
`flowmusic_write_lyrics`	Escreve letras `[Verse]` / `[Chorus]`, um título e um prompt de som para um conceito de música, sem criar a música.	`prompt`, `structure`, `email`
`flowmusic_list_songs`	Lista os clipes de uma conta, do mais recente ao mais antigo.	`email`, `limit`, `offset`
`flowmusic_get_job`	Lê uma música ou trabalho de edição e, com `wait: true`, aguarda a conclusão.	`jobid`, `wait`
`flowmusic_list_jobs`	Lista os trabalhos em execução agora em cada conta.
`flowmusic_cancel_job`	Para de rastrear um trabalho e libera seu slot. O Flow Music pode ainda concluir a música, e os créditos são gastos de qualquer forma.	`jobid`

Os parâmetros correspondem a POST /music e POST /music/lyrics.

Edições

Cada edição de POST /music/edit é uma ferramenta própria. Todas recebem o clip a editar e um title e seed opcionais.

Ferramenta	O que faz	Parâmetros principais
`flowmusic_extend_song`	Adiciona música a um clipe, de 1 a 300 segundos (150 por padrão).	`instruction`, `extend_s`, `extend_from_s`, `model`
`flowmusic_replace_section`	Regenera uma seção de um clipe.	`instruction`, `mask_start_s`, `mask_end_s`, `model`
`flowmusic_cover_song`	Reestiliza um clipe inteiro.	`instruction`, `strength`, `model`
`flowmusic_remix_lyrics`	Regrava um clipe com letras editadas, mantendo o som.	`lyrics`, `prompt`, `model`
`flowmusic_apply_effect`	Aplica um efeito: Trim, Fade, Gain, Reverb, Pan ou Equalizer.	`effect` e os parâmetros desse efeito
`flowmusic_split_stems`	Divide um clipe em quatro faixas: bateria, baixo, vocais e outros.	`clip`

Arquivos de referência

Ferramenta	O que faz	Parâmetros principais
`flowmusic_upload_file`	Envia uma imagem JPEG, PNG ou WebP (até 20 MB) ou uma música MP3, WAV ou M4A (até 40 MB) de uma URL https pública, ou enviada como `contentBase64`, como referência para `flowmusic_create_song`.	`url` ou `contentBase64`, `mimeType`, `email`, `stripMetadata`
`flowmusic_generate_image`	Gera uma imagem para usar como referência, retornada como uma imagem que o assistente pode ver.	`prompt`, `email`

Referências são dicas aproximadas: nenhum modelo Lyria copia uma música ou imagem enviada. O esquema completo de entrada de cada ferramenta vem de tools/list.

Trabalhos de longa duração

Clientes MCP geralmente desistem de uma chamada de ferramenta após cerca de um minuto, então uma ferramenta aguarda até cerca de 50 segundos:

Uma música normalmente leva de 30 segundos a um minuto, às vezes até dois minutos e meio. Se não terminar a tempo, a ferramenta retorna o jobid, e flowmusic_get_job com wait: true retoma. Peça ao assistente para continuar verificando até concluir.
Um remix leva cerca de 20 a 30 segundos e um efeito menos de meio minuto. Estender, substituir e fazer cover levam aproximadamente o mesmo tempo que uma música.
flowmusic_write_lyrics responde em cerca de 30 segundos e flowmusic_split_stems em 15 a 60 segundos. Se uma divisão em faixas demorar mais, chame novamente um minuto depois: um clipe já dividido retorna suas faixas imediatamente.

Clientes que solicitam notificações de progresso recebem uma a cada 10 segundos enquanto uma ferramenta aguarda.

Cada clipe retorna com seu id e links públicos m4a e wav. O mp3 vem via GET /music/download com o mesmo cabeçalho Authorization.

Exemplos de prompts

“Escreva letras para uma música animada sobre um cachorro chamado Biscuit que ama a praia, depois faça como indie pop com vocal feminino caloroso.”
“Faça um instrumental lo-fi hip hop de 2 minutos para estudar, usando Lyria 3.5.”
“Estenda minha última música em 30 segundos com um final que desaparece gradualmente.”
“Faça um cover lento de bossa nova dessa música.”
“Regrave o segundo verso com estas novas letras: …”
“Divida a música em faixas e me dê a faixa de vocais.”
“Quantos créditos do Flow Music restam nas minhas contas?”

Limites e observações

As ferramentas usam suas contas do Flow Music e as mesmas regras da API REST, como maxJobs. Músicas e edições usam os créditos do Flow Music da conta; veja a calculadora de custos na página FlowMusic API.
Conectores personalizados no claude.ai precisam de login OAuth, que este servidor ainda não suporta. Use Claude Code ou outro cliente que possa enviar um cabeçalho Authorization.
Um cliente pode enviar até 20 solicitações JSON-RPC em um único lote.
Se o cliente enviar um cabeçalho MCP-Protocol-Version, ele deve ser uma das versões suportadas: 2025-06-18, 2025-03-26 ou 2024-11-05.
Cada chamada de ferramenta aparece nas suas estatísticas de uso ( bot=flowmusic) como modelo mcp, com o nome da ferramenta como status, ou failed.

Tutoriais para a FlowMusic API v1:

{ "@context": "https://schema.org", "@type": "APIReference", "name": "Flow Music MCP Server: Lyria 3.5 Songs, Covers and Stems", "url": "https://useapi.net/docs/api-flowmusic-v1/mcp", "inLanguage": "en", "isAccessibleForFree": true, "description": "Connect Claude Code, Cursor, VS Code or any MCP client to the hosted useapi.net Flow Music MCP server: 18 tools for Lyria songs, lyrics, edits and stems.", "about": "FlowMusic API v1", "isPartOf": { "@type": "APIReference", "name": "FlowMusic API v1" }, "publisher": { "@type": "Organization", "name": "useapi.net", "url": "https://useapi.net", "logo": { "@type": "ImageObject", "url": "https://useapi.net/assets/brand/useapi-logo-512.png" }, "alternateName": ["useapi", "UseAPI"], "sameAs": ["https://discord.gg/w28uK3cnmF", "https://t.me/use_api", "https://github.com/useapi", "https://bsky.app/profile/useapi.net", "https://www.youtube.com/@useapi-net"] }, "documentationOf": { "@type": "WebAPI", "name": "useapi.net REST API", "documentation": "https://useapi.net/llms.txt", "termsOfService": "https://useapi.net/docs/legal" } }
{ "@context": "https://schema.org", "@type": "BreadcrumbList", "itemListElement": [ { "@type": "ListItem", "position": 1, "name": "Home", "item": "https://useapi.net/" }, { "@type": "ListItem", "position": 2, "name": "FlowMusic API v1", "item": "https://useapi.net/docs/api-flowmusic-v1" }, { "@type": "ListItem", "position": 3, "name": "MCP Server", "item": "https://useapi.net/docs/api-flowmusic-v1/mcp" } ] }