Lacuna MCP Server

@JOYLINK-LTD

Basic information

About Lacuna MCP Server

Model Context Protocol server for the Lacuna Music API — generate AI music from Claude Desktop, Claude Code, Cursor, Zed, and other MCP-compatible clients.

#music #ai #music-generation #mcp #claude#lacuna

Lacuna MCP Server config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "lacuna": {
      "command": "npx",
      "args": [
        "-y",
        "lacuna-mcp"
      ],
      "env": {
        "LACUNA_API_KEY": "lyr_live_..."
      }
    }
  }
}

Lacuna MCP Server tools

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.

Retrieve the current state of a music generation task by id.

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.

Overview

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.

Frequently asked questions

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.

Comments

More Developer Tools MCP servers

ZeroBeacon — 1000-Tool Collision-Proof Commerce Router

DavidFox998

ZeroBeacon.ai — Collision-proof commerce router for AI agents. 1000 MCP tools: commerce, trust, billing, sovereign ID + everyday tools. LIVE.

Foremerge

naw103

Catch intent conflicts before code conflicts. The open-source coordination protocol for coding agents, built above Git.

Vibgrate MCP

Vibgrate

Query your team's drift, vulnerability, and migration data from any AI assistant. Vibgrate MCP connects Cursor, Claude, ChatGPT, Windsurf, or VS Code to Vibgrate Cloud: 51 tools for DriftScores, CVEs and EOL runtimes, up

Casefile

azimov777

One case file per task — shared by every session, agent and person that touches it. Self-hosted MCP server and live board. MIT.

FARPY

mangomunchr

Verified distributed compute for humans, applications, and agents. Submit Blender, Octane, and video workloads, route them across qualified GPUs, track asynchronous execution, download finished artifacts, and verify FARP