Flow Music MCP Server by useapi.net

Google Flow Music (Lyria): canciones, letras, extender, versión cover, remix, efectos, pistas separadas. De terceros, de pago ($15/mes), funciona con tu propia cuenta de Flow Music.

Ver en useapi.net

Servidor MCP alojado

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

Se instala en Claude Code, Codex, Cursor y más

Documentación

Saltar al contenido principal

Servidor MCP de Flow Music

16 de octubre de 2026

El servidor MCP de Flow Music de useapi.net permite que un asistente de IA como Claude Code, Cursor o VS Code Copilot cree música con Google Flow Music en tus propias cuentas de Flow Music. Es un servidor alojado de Model Context Protocol con 18 herramientas: genera canciones con los modelos Lyria de Google a partir de una descripción, tus propias letras o letras que escribe el modelo, y luego extiéndelas, regenera una sección, cambia su estilo, vuelve a cantarlas con nuevas letras, aplica efectos de audio o sepáralas en pistas. Cada herramienta llama a la API de FlowMusic, por lo que se aplican las mismas reglas y límites. No es necesario instalar ni alojar nada.

¿Existe un servidor MCP de Flow Music? Sí. useapi.net, un servicio de terceros no afiliado a Google, aloja uno en https://api.useapi.net/v1/flowmusic/mcp con 18 herramientas para canciones Lyria, versiones, remezclas y pistas, en tu propia cuenta de Flow Music, sin necesidad de instalar nada.

¿Prefieres REST? Tutorial: Cómo generar música IA con Lyria 3 Pro mediante la API de Flow Music · Código: github.com/useapi/flowmusic-api

Consulta todos los servidores MCP de useapi.net en Model Matrix & MCP.

Endpoint y autorización

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

Transporte: HTTP Streamable.
Listado en el registro oficial de MCP como net.useapi/flowmusic, por lo que los clientes y directorios MCP que lean el registro pueden encontrarlo por ese nombre.
Autorización: tu token de API de useapi.net en el encabezado Authorization: Bearer …, consulta Configurar useapi.net.
Necesitas al menos una cuenta de Flow Music añadida con Configurar Flow Music. Añadir y eliminar cuentas no está disponible a través de MCP: usa POST /accounts o la página de configuración.

Configuración

Reemplaza YOUR_API_TOKEN con tu token de API de 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

En ~/.cursor/mcp.json:

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

VS Code

En .vscode/mcp.json:

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

Windsurf y otros clientes

Cualquier cliente que admita servidores MCP remotos a través de HTTP con encabezados personalizados funciona. La forma JSON habitual:

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

Algunos clientes nombran el campo de dirección url en lugar de serverUrl.

Pruébalo con 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"}'

La primera llamada responde con el nombre del servidor useapi-flowmusic y sus instrucciones para el asistente, la segunda con las 18 herramientas.

Herramientas

Las canciones, clips y archivos subidos se nombran por los ids que devuelven las herramientas, y cada id lleva su cuenta, por lo que una edición se ejecuta en la cuenta que posee el clip. Las herramientas que inician una canción aceptan un email opcional para elegir la cuenta.

Cuentas

Herramienta	Qué hace	Parámetros principales
`flowmusic_list_accounts`	Lista tus cuentas con su plan, `maxJobs` y estado.
`flowmusic_get_account`	Lee una cuenta en vivo: plan, créditos y tokens restantes.	`email`
`flowmusic_update_account`	Establece `maxJobs`, las canciones y ediciones que una cuenta ejecuta a la vez.	`email`, `maxJobs`
`flowmusic_get_usage`	Devuelve el uso de créditos de una cuenta: eventos de facturación diarios y el costo de cada canción.	`email`

Canciones y letras

Herramienta	Qué hace	Parámetros principales
`flowmusic_create_song`	Genera una canción a partir de una descripción del estilo, ambiente, instrumentos y voces, con tus propias letras, letras que escribe el modelo, o instrumental.	`prompt`, `lyrics`, `instrumental`, `ghostwriter`, `model`, `refImage1`..`10`, `refAudio1`..`10`, `email`
`flowmusic_write_lyrics`	Escribe letras de `[Verse]` / `[Chorus]`, un título y una indicación de sonido para un concepto de canción, sin crear la canción.	`prompt`, `structure`, `email`
`flowmusic_list_songs`	Lista los clips en una cuenta, los más recientes primero.	`email`, `limit`, `offset`
`flowmusic_get_job`	Lee una canción o un trabajo de edición, y con `wait: true` espera a que termine.	`jobid`, `wait`
`flowmusic_list_jobs`	Lista los trabajos en ejecución ahora en cada cuenta.
`flowmusic_cancel_job`	Deja de rastrear un trabajo y libera su espacio. Flow Music puede seguir terminando la canción, y sus créditos se gastan de todos modos.	`jobid`

Los parámetros coinciden con POST /music y POST /music/lyrics.

Ediciones

Cada edición de POST /music/edit es su propia herramienta. Cada una toma el clip a editar y un title y seed opcionales.

Herramienta	Qué hace	Parámetros principales
`flowmusic_extend_song`	Añade música a un clip, de 1 a 300 segundos (150 por defecto).	`instruction`, `extend_s`, `extend_from_s`, `model`
`flowmusic_replace_section`	Regenera una sección de un clip.	`instruction`, `mask_start_s`, `mask_end_s`, `model`
`flowmusic_cover_song`	Cambia el estilo de todo un clip.	`instruction`, `strength`, `model`
`flowmusic_remix_lyrics`	Vuelve a cantar un clip con letras editadas, manteniendo su sonido.	`lyrics`, `prompt`, `model`
`flowmusic_apply_effect`	Aplica un efecto: Recortar, Fundido, Ganancia, Reverberación, Panorámica o Ecualizador.	`effect` y los parámetros de ese efecto
`flowmusic_split_stems`	Divide un clip en cuatro pistas: batería, bajo, voces y otros.	`clip`

Archivos de referencia

Herramienta	Qué hace	Parámetros principales
`flowmusic_upload_file`	Sube una imagen JPEG, PNG o WebP (hasta 20 MB) o una canción MP3, WAV o M4A (hasta 40 MB) desde una URL https pública, o enviada como `contentBase64`, como referencia para `flowmusic_create_song`.	`url` o `contentBase64`, `mimeType`, `email`, `stripMetadata`
`flowmusic_generate_image`	Genera una imagen para usar como referencia, devuelta como una imagen que el asistente puede ver.	`prompt`, `email`

Las referencias son indicaciones flexibles: ningún modelo Lyria copia una canción o imagen subida. El esquema completo de entrada de cada herramienta proviene de tools/list.

Trabajos de larga duración

Los clientes MCP suelen abandonar una llamada de herramienta después de aproximadamente un minuto, por lo que una herramienta espera hasta unos 50 segundos:

Una canción suele tardar de 30 segundos a un minuto, a veces hasta dos y medio. Si no termina a tiempo, la herramienta devuelve el jobid, y flowmusic_get_job con wait: true lo retoma. Pide al asistente que siga comprobando hasta que termine.
Una remezcla tarda unos 20 a 30 segundos y un efecto menos de medio minuto. Extender, reemplazar y versionar tardan aproximadamente lo mismo que una canción.
flowmusic_write_lyrics responde en unos 30 segundos y flowmusic_split_stems en 15 a 60 segundos. Si una separación en pistas tarda más, vuelve a llamarla un minuto después: un clip ya separado devuelve sus pistas de inmediato.

Los clientes que solicitan notificaciones de progreso reciben una aproximadamente cada 10 segundos mientras una herramienta espera.

Cada clip regresa con su id y enlaces públicos m4a y wav. El mp3 llega a través de GET /music/download con el mismo encabezado Authorization.

Ejemplos de indicaciones

“Escribe letras para una canción alegre sobre un perro llamado Biscuit que ama la playa, luego hazla como indie pop con una voz femenina cálida.”
“Haz un instrumental de lo-fi hip hop de 2 minutos para estudiar, usando Lyria 3.5.”
“Extiende mi última canción 30 segundos con un final que se desvanezca.”
“Haz una versión lenta de bossa nova de esa canción.”
“Vuelve a cantar la segunda estrofa con estas nuevas letras: …”
“Divide la canción en pistas y dame la pista de voces.”
“¿Cuántos créditos de Flow Music quedan en mis cuentas?”

Límites y notas

Las herramientas usan tus cuentas de Flow Music y las mismas reglas que la API REST, como maxJobs. Las canciones y ediciones usan los créditos de Flow Music de la cuenta, consulta la calculadora de costos en la página de FlowMusic API.
Los conectores personalizados en claude.ai necesitan inicio de sesión OAuth, que este servidor aún no admite. Usa Claude Code u otro cliente que pueda enviar un encabezado Authorization.
Un cliente puede enviar hasta 20 solicitudes JSON-RPC en un solo lote.
Si el cliente envía un encabezado MCP-Protocol-Version, debe ser una de las versiones admitidas: 2025-06-18, 2025-03-26 o 2024-11-05.
Cada llamada de herramienta aparece en tus estadísticas de uso ( bot=flowmusic) como modelo mcp, con el nombre de la herramienta como su estado, o failed.

Tutoriales para la API de FlowMusic 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" } ] }