概要
What is Lacuna MCP?
Lacuna MCP is a Model Context Protocol server that integrates with the Lacuna Music API. It enables MCP-compatible clients (Claude Desktop, Claude Code, Cursor, Zed, Continue, etc.) to generate AI music as part of an agent loop.
How to use Lacuna MCP?
The server is a single npm package run over stdio. No install step is needed — your MCP client launches it via npx lacuna-mcp. Configure it by setting the LACUNA_API_KEY environment variable (required, from your profile dashboard, begins with lyr_live_). An optional LACUNA_BASE_URL can override the API base URL. Music API access requires the Pro plan or above.
Key features of Lacuna MCP
- Create music generation tasks and get immediate pending task IDs.
- Retrieve the current state of a generation task by its ID.
- Poll a generation task until it completes or fails.
Use cases of Lacuna MCP
- Generate AI music autonomously within an agent workflow.
- Check generation status and retrieve completed tracks programmatically.
- Integrate music creation into multi-step AI processes.
FAQ from Lacuna MCP
What does Lacuna MCP do exactly?
It exposes three tools — generate_music, get_generation, and wait_for_generation — for creating and monitoring AI music generation tasks via the Lacuna Music API.
What are the prerequisites to use Lacuna MCP?
Node.js 18 or newer, an API key from a Lacuna account on the Pro plan or above, and an MCP-compatible client.
How do I install and configure it?
No installation is needed; run it via npx lacuna-mcp. Set the LACUNA_API_KEY environment variable. For Claude Desktop, add an entry to the mcpServers JSON config; for Claude Code, use claude mcp add.
What runtime or dependencies are required?
Node.js 18+ and a valid API key. The server runs over stdio and is published as an npm package.
Is there a free tier or trial for the API?
The README does not mention a free tier. It states that the Music API requires a Pro plan or above.
