lacuna-music

lacuna-music

Generate AI music programmatically through the Lacuna Music API.

When to use this

Activate when the user wants to:

• Generate a track from a style description ("lofi piano, 70 bpm", "synthwave, retro drums")
• Add background music to a video, demo, presentation, or app
• Produce a jingle, intro, outro, or stinger from a brief
• Compose a vocal song from custom lyrics

Pick a transport

Three packages, same underlying API. Pick the first that fits the user's environment:

When the user is using…	Use
Claude Code, Claude Desktop, Cursor, Zed, or another MCP client	lacuna-mcp
A Node / TypeScript script or backend	lacuna-sdk
Their shell, a CI job, a one-off prompt	lacuna-toolkit

lacuna-mcp (preferred for AI agents)

claude mcp add lacuna -- npx -y lacuna-mcp

Set LACUNA_API_KEY in the MCP env block. After adding, three tools become available: generate_music, get_generation, wait_for_generation. Call generate_music then wait_for_generation to receive the final audio_url.

lacuna-sdk

import Lacuna from 'lacuna-sdk'

const lacuna = new Lacuna({ apiKey: process.env.LACUNA_API_KEY })

const task = await lacuna.music.generations.create({
  style: 'lofi piano, 70 bpm, mellow',
  title: 'Study session',
  instrumental: true,
})

const finished = await lacuna.music.generations.waitFor(task.id)
console.log(finished.tracks[0]?.audio_url)

lacuna-toolkit

npx lacuna-toolkit music generate \
  --style "synthwave, retro drums, 110 bpm" \
  --title "Neon Drive" \
  --instrumental \
  --wait \
  --output json

Authentication

Get a key at lacuna.fm/profile/api. It begins with lyr_live_ and is shown once at creation. Pass it via LACUNA_API_KEY env var.