MCP Server

Lacuna Music

io.github.JOYLINK-LTD/lacuna-mcp
Design & Creative Media & Content Public & reachable MCP 2026-07-28

What this MCP does

Creates AI-generated music tasks, reports generation status, and lists available music models.

generate_music
Generate music
Create an AI music generation task on Lacuna. Returns immediately with a `pending` task; poll `get_generation` to retrieve the finished tracks and their audio URLs.
Open world
Input schema
{'type': 'object', 'required': ['style', 'title'], 'properties': {'model': {'enum': ['aether', 'echo'], 'type': 'string', 'description': 'Generation model. Defaults to `aether`. Call `list_models` for what each one covers.'}, 'style': {'type': 'string', 'maxLength': 1000, 'description': 'Style description, e.g. "pop, female vocal, 120 bpm, energetic".'}, 'title': {'type': 'string', 'maxLength': 200, 'description': 'Track title.'}, 'lyrics': {'type': 'string', 'maxLength': 5000, 'description': 'Lyrics in plain text. Required unless `instrumental` is true.'}, 'audio_weight': {'type': 'number', 'maximum': 1, 'minimum': 0, 'description': 'Audio reference weight 0–1 (aether only).'}, 'instrumental': {'type': 'boolean', 'description': 'Generate an instrumental track (no lyrics). Defaults to false.'}, 'style_weight': {'type': 'number', 'maximum': 1, 'minimum': 0, 'description': 'Style weight 0–1 (aether only).'}, 'vocal_gender': {'enum': ['m', 'f'], 'type': 'string', 'description': 'Lead vocal gender hint (aether only).'}, 'negative_tags': {'type': 'string', 'maxLength': 500, 'description': 'Negative style tags to avoid (aether only).'}, 'weirdness_constraint': {'type': 'number', 'maximum': 1, 'minimum': 0, 'description': 'Weirdness constraint 0–1 (aether only).'}}, 'additionalProperties': False}
get_generation
Get generation
Retrieve the current state of a music generation task by id. Status is `pending`, `ready`, or `failed`; audio URLs appear on `ready`.
Read only
Input schema
{'type': 'object', 'required': ['id'], 'properties': {'id': {'type': 'string', 'description': 'Generation task id, returned by generate_music.'}}, 'additionalProperties': False}
list_models
List models
List the music models available through the API, with their credit cost per task, tracks produced per task, and language coverage.
Read only
Input schema
{'type': 'object', 'properties': {}, 'additionalProperties': False}
Added
list_models
Sept. 17, 2026, 12:42 p.m.
Added
get_generation
Sept. 17, 2026, 12:42 p.m.
Added
generate_music
Sept. 17, 2026, 12:42 p.m.