Lacuna Music
Generador de canciones con IA y generador de letras con IA de Lacuna como herramientas MCP: genera canciones completas con voces, escribe letras y obtén el audio terminado desde cualquier cliente MCP.
Documentación
1
Obtén una clave de API
La API de Música requiere el plan Pro o superior. Crea una clave en tu panel de control: se muestra una sola vez, así que cópiala directamente en un administrador de secretos. Las claves comienzan con lyr_live_.
Abrir panel de controlVer precios
2
Conecta tu cliente
El servidor habla stdio, el transporte estándar de MCP, y se ejecuta directamente desde npm: no hay nada que clonar ni compilar. En Claude Code, un solo comando lo registra:
claude mcp add lacuna \
--env LACUNA_API_KEY=lyr_live_xxx \
-- npx -y lacuna-mcp
Claude Desktop, Cursor, Zed y otros clientes aceptan el mismo servidor como una entrada JSON. Coloca esto en el archivo de configuración de MCP del cliente:
{
"mcpServers": {
"lacuna": {
"command": "npx",
"args": ["-y", "lacuna-mcp"],
"env": {
"LACUNA_API_KEY": "lyr_live_xxx"
}
}
}
}
Configura también LACUNA_BASE_URL si necesitas apuntar el servidor a un host de API diferente; de lo contrario, el valor predeterminado es correcto.
3
Solicita una pista
Reinicia el cliente y las herramientas aparecerán. A partir de aquí es lenguaje natural: el agente elige las herramientas, consulta la tarea y devuelve una URL de audio alojada.
You: Make me a lofi track for a study playlist — mellow piano,
around 70 bpm, no vocals. Call it "Late Night Study".
Claude: [generate_music] → task gen_cm123abc, status pending
[wait_for_generation] → status ready
Done — here's the track:
https://cdn.lacuna.fm/music/.../late-night-study.mp3
La generación es asíncrona y normalmente tarda uno o dos minutos. Los créditos se descuentan por adelantado según la tarifa del modelo seleccionado y se reembolsan automáticamente si la generación upstream falla.
Herramientas expuestas al agente
generate_music
Crea una tarea de generación a partir de una descripción de estilo, letras opcionales y un título.
Devuelve inmediatamente una tarea pendiente. Acepta style\, title\, lyrics\, instrumental\ y model\.
wait_for_generation
Consulta una tarea hasta que esté lista o haya fallado, y luego devuelve las pistas terminadas.
El intervalo predeterminado es de 5 segundos y el tiempo de espera de 10 minutos; ambos son ajustables por llamada.
get_generation
Lee el estado actual de una tarea por id sin bloquear.
Útil cuando el agente quiere verificar una tarea larga entre otros trabajos.
Elegir un modelo
El parámetro model es opcional. Si lo omites, el agente obtiene aether. Las tarifas de crédito difieren porque los modelos cuestan cantidades distintas de ejecutarse, no porque uno sea de un nivel superior al otro.
| Modelo | Para qué sirve |
|---|---|
| aether | El predeterminado. Voces más controles de peso de estilo; el único modelo que puede extender, versionar o reemplazar secciones. |
| echo | Pistas estructuradas completas de hasta tres minutos. La duración la decide el modelo, por lo que no hay parámetro de duración. |
¿No usas MCP? Dos rutas alternativas
La misma API por debajo: elige la que se adapte a donde se ejecute tu agente.
Agent Skill
lacuna-music es una habilidad empaquetada para agentes que leen archivos SKILL.md. Enseña al agente cuándo recurrir a la música y qué transporte usar.
SDK y CLI
Para tu propio backend o un trabajo de CI, lacuna-sdk es un cliente TypeScript tipado y lacuna-toolkit te da un comando lacuna.