lacuna-musiclisted
Install: claude install-skill JOYLINK-LTD/lacuna-toolkit
# lacuna-music
Generate AI music programmatically through the [Lacuna Music API](https://lacuna.fm).
## 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)
```sh
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`
```ts
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'