Skip to main content
Glama

Lacuna Music Plugin

Generate original instrumental music and vocal songs from Claude Code or Codex using Lacuna's published Model Context Protocol server.

Capabilities

  • 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

Requirements

  • 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.

Install in Claude Code

/plugin marketplace add JOYLINK-LTD/lacuna-plugin
/plugin install lacuna-music@lacuna

Export LACUNA_API_KEY in the environment Claude Code runs in, then run /reload-plugins if the install summary asks for it.

Install in Codex

codex plugin marketplace add JOYLINK-LTD/lacuna-plugin
codex plugin add lacuna-music@lacuna

Make LACUNA_API_KEY available to Codex, restart the app, and test the plugin in a new task.

Tools

Tool

Purpose

generate_music

Creates a generation task and returns its pending task ID.

get_generation

Retrieves the current state of a generation task.

wait_for_generation

Polls until a task becomes ready or failed.

Repository layout

  • .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.

Security

Do not commit or paste a Lacuna API key into this repository. See SECURITY.md for reporting instructions.

License

MIT

Maintenance

ActivityMaintained
ResponsivenessSyncing

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Related MCP Connectors

Related MCP Servers

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/JOYLINK-LTD/lacuna-plugin'

If you have feedback or need assistance with the MCP directory API, please join our Discord server