Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type @ followed by the MCP server name and your instructions, e.g., "@lacuna-music generate an upbeat electronic instrumental"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Generate original instrumental music and vocal songs from Claude Code or Codex using Lacuna's published Model Context Protocol server.
Generate an instrumental from a natural-language style description.
Turn supplied lyrics into a complete song with vocals.
Retrieve a generation or wait until its audio URLs are ready.
Music generation spends credits from the authenticated Lacuna account. The MCP server returns a pending task immediately; clients should poll approximately every 10 seconds rather than busy-looping.
Related MCP server: Suno MCP
A Lacuna account on Pro or higher.
A LACUNA_API_KEY created at Lacuna API settings with the music:generate scope.
Node.js 18 or newer so the client can launch the pinned lacuna-mcp@0.3.3 package.
/plugin marketplace add JOYLINK-LTD/lacuna-plugin
/plugin install lacuna-music@lacunaExport LACUNA_API_KEY in the environment Claude Code runs in, then run /reload-plugins if the install summary asks for it.
codex plugin marketplace add JOYLINK-LTD/lacuna-plugin
codex plugin add lacuna-music@lacunaMake LACUNA_API_KEY available to Codex, restart the app, and test the plugin in a new task.
Tool | Purpose |
| Creates a generation task and returns its pending task ID. |
| Retrieves the current state of a generation task. |
| Polls until a task becomes |
.claude-plugin/marketplace.json — installable Claude Code marketplace.
.claude-plugin/plugin.json — Claude Code plugin manifest (MCP server declared inline).
.agents/plugins/marketplace.json — installable Codex marketplace.
.codex-plugin/plugin.json — Codex plugin manifest.
.mcp.json — pinned stdio MCP connection (Codex schema; Claude Code reads its own copy from .claude-plugin/plugin.json).
See the MCP documentation and Lacuna Toolkit for the SDK, CLI, and standalone MCP package.
Do not commit or paste a Lacuna API key into this repository. See SECURITY.md for reporting instructions.
MIT
This server cannot be deployed
AI music studio: song generation with vocals, covers, stems, voice conversion, mastering, editing.
Write lyrics in 100+ styles, score them, generate full songs with 4 engines, split stems. OAuth.
Generate Suno AI music (v5.5) from any MCP client. Async; billed only on success.
Create and track AI music videos and audio-reactive visuals from songs.
