Lacuna MCP
About
Model Context Protocol server for the Lacuna Music API — generate AI music from Claude Desktop, Claude Code, Cursor, Zed, and other MCP-compatible clients.
Explore
- 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.
Setting up with Highlight
This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:
- Download and install Highlight from highlightai.com/download
- Navigate to the plugins tab and select "Add Custom Plugin"
-
Configure the plugin with the settings below
Plugin Name
Lacuna MCPCommand (node, npx, python, etc.)Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
- Enable "Start Automatically" if you want the plugin to start when Highlight launches
From the repository
The server is published as a single npm package and runs over stdio. No install step is needed — your MCP client launches it via npx.
``sh``
npx lacuna-mcp
generate_music
Create an AI music generation task on Lacuna. Returns immediately with a `pending` task; use `wait_for_generation` or `get_generation` to retrieve the finished tracks.
get_generation
Retrieve the current state of a music generation task by id.
wait_for_generation
Poll a generation task until it reaches a terminal state (`ready` or `failed`) or the timeout elapses. Returns the final task object including audio URLs on success.
| Tool | Description |
| ------------------------- | ---------------------------------------------------------------------------------------------------- |
| generate_music | Create a music generation task. Returns a pending task immediately. |
| get_generation | Retrieve the current state of a generation task by id. |
| wait_for_generation | Poll a task until it reaches a terminal state (ready or failed) or the timeout elapses. |
Claude Desktop / Cursor
Paste into your MCP client config file to install this server.
{
"mcpServers": {
"lacuna mcp": {
"lacuna": {
"command": "npx",
"args": [
"-y",
"lacuna-mcp"
],
"env": {
"LACUNA_API_KEY": "lyr_live_..."
}
}
}
}
}McpServers
{
"lacuna": {
"command": "npx",
"args": [
"-y",
"lacuna-mcp"
],
"env": {
"LACUNA_API_KEY": "lyr_live_..."
}
}
}Installation
The server is published as a single npm package and runs over stdio. No install step is needed — your MCP client launches it vianpx.
``sh
npx lacuna-mcp
`
Configuration
| Variable | Required | Description |
| ------------------ | -------- | --------------------------------------------------------------------------- |
| LACUNA_API_KEY | yes | API key from your profile dashboard. Begins with lyr_live_. |
| LACUNA_BASE_URL | no | Override the API base URL (e.g. for staging). |
Music API access requires the Pro plan or above.
Claude Desktop
`json
{
"mcpServers": {
"lacuna": {
"command": "npx",
"args": ["-y", "lacuna-mcp"],
"env": {
"LACUNA_API_KEY": "lyr_live_..."
}
}
}
}
`
Claude Code
`sh
claude mcp add lacuna -- npx -y lacuna-mcp
`
Tools
| Tool | Description |
| ------------------------- | ---------------------------------------------------------------------------------------------------- |
| generate_music | Create a music generation task. Returns a pending task immediately. |
| get_generation | Retrieve the current state of a generation task by id. |
| wait_for_generation | Poll a task until it reaches a terminal state (ready or failed`) or the timeout elapses. |
Requirements
- Node.js 18 or newer. - An API key from a Lacuna Pro plan or above.License
MIT © Louis TsangSign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
