Lacuna

Lacuna (lacuna.fm), operated by JOYLINK LTD, is an AI music creation platform that turns lyrics or a plain-text style description into complete songs with vocals, alongside lyrics writing, word-level timed lyrics (LRC/SRT/VTT), lyric video export, AI mastering, mashups, stem separation, album-cover art, MIDI tooling and sheet-music conversion, plus long-form AI radio for focus, sleep and ambience. Developers get a documented REST music-generation API (OpenAPI 3.1 published at /api/openapi.json), an official TypeScript SDK, a `lacuna` CLI, and an unusually complete agent surface: a hosted Streamable-HTTP MCP server at /mcp with an anonymous tools/list, an A2A JSON-RPC agent endpoint at /a2a with a published agent card, an RFC 9727 api-catalog, RFC 8414 / RFC 9728 OAuth discovery, an agent-oriented auth.md, an llms.txt, and a packaged Agent Skill. API access requires a Pro plan or above and is billed in credits per generation.

Lacuna publishes 2 APIs on the APIs.io network: Lacuna Music API API and Music API. Tagged areas include AI Music, Music Generation, AI Song Generator, AI Lyrics Generator, and Audio.

The Lacuna catalog on APIs.io includes 1 event-driven AsyncAPI specification.

Lacuna’s developer surface includes documentation, API reference, getting-started guide, support, engineering blog, pricing, signup flow, and 34 more developer resources.

🌐 Visit website 📡 Source on GitHub
65.5/100 strong ▬ flat Agent 62/100 agent ready Full breakdown ↓
scored 2026-08-12 · rubric v0.11.0
4 APIs 1 MCP Servers
AI MusicMusic GenerationAI Song GeneratorAI Lyrics GeneratorAudioMIDISongwritingGenerative AIMCP ServerAgent SkillA2ADeveloper Tools

Kin Score

Kin Score Kin Score How this is scored →
scored 2026-08-12 · rubric v0.11.0
Composite quality — 65.5/100 · strong
Contract Quality 14.3 / 25
Developer Ergonomics 16.1 / 20
Commercial Clarity 15.3 / 20
Operational Transparency 9.2 / 13
Governance 2.5 / 12
Discoverability 8.2 / 10
Agent readiness — 62/100 · agent ready
Machine-Readable Contract 18 / 18
Agentic Access Contract 10 / 10
MCP Server 12 / 12
Machine-Readable Auth 10 / 10
Idempotency 0 / 9
Stable Error Semantics 8 / 8
Request/Response Examples 7 / 7
Rate-Limit Signaling 7 / 7
Typed Event Surface 6 / 6
Agent Skills 5 / 5
Well-Known Catalog 0 / 4
Consent & Bot Identity 3 / 3
A2A Agent Card 8 / 8
Dry-Run / Simulate Mode 0 / 4
Improve this rating by publishing the missing artifacts — every area above can be raised, and the full rubric is at apis.io/rating/. This rating is computed from github.com/api-evangelist/lacuna: open an issue to ask a question, or submit a pull request to add artifacts. Want it done for you? Prioritized profiling — $2,500 →

APIs 4

Individual APIs this provider publishes, each with its own machine-readable definition.

Lacuna MCP Server

Hosted Model Context Protocol server (Streamable HTTP) at https://www.lacuna.fm/mcp, protocol 2025-06-18. initialize and tools/list answer anonymously and return real input sche...

Lacuna A2A Agent

Agent-to-Agent JSON-RPC endpoint at https://www.lacuna.fm/a2a advertising the "Lacuna Music" agent card at /.well-known/agent-card.json (protocolVersion 0.3.0). One skill, gener...

Lacuna Lacuna Music API API

The Lacuna Music API API from Lacuna — 0 operation(s) for lacuna music api.

Lacuna Music API

Music generation endpoints.

Arazzo Workflows 1

Multi-step API workflows described with the Arazzo specification.

Generate a Lacuna track and collect the audio

Submits a music generation task to the Lacuna Music API, polls it to a terminal state, and returns the hosted audio URL of the first rendered track. Both operationIds are verifi...

ARAZZO

MCP Servers 1

Model Context Protocol servers that expose these APIs to AI agents.

lacuna-mcp.yml

MCP SERVER

Pricing Plans 1

Published pricing tiers and plan structures.

Lacuna Plans

4 plans

PLANS

Rate Limits 1

Documented rate limits and quota policies.

Lacuna Rate Limits

3 limits

RATE LIMITS

Event Specifications 1

AsyncAPI definitions for this provider's event-driven and streaming APIs.

Lacuna Webhooks

ASYNCAPI

Security Posture 3

Authentication, domain security, vulnerability disclosure, and trust-center signals.

Lacuna Authentication

http/oauth2 · 2 schemes

SECURITY

Lacuna Domain Security

TLSv1.3 · HSTS · DMARC

SECURITY

Lacuna Vulnerability Disclosure

security.txt · contact published

SECURITY

Scopes 1

OAuth scopes governing access to this provider's APIs.

Lacuna Scopes

5 scopes · authorizationCode

5 scopes

SCOPES

Agentic Access 1

Recommended x-agentic-access execution contracts for AI agents.

Lacuna Agentic Access

2 operations · 1 acting

2 operations · 1 acting

AGENTIC

Resources

Get Started 3

Portal, sign-up, and the first successful call

DeveloperPortal
DeveloperPortal
 GettingStarted
GettingStarted
 SignUp
SignUp

Documentation 3

Reference material describing how the API behaves

Documentation
Documentation
 APIReference
APIReference
 OpenAPI
OpenAPI

Agent Surfaces 5

MCP servers, agent skills, and machine-readable catalogs

AgenticAccess
AgenticAccess
 LLMsTxt
LLMsTxt
 WellKnown
WellKnown
 MCPServer
MCPServer
 AgentSkill
AgentSkill

Design & Contract 7

Pagination, idempotency, versioning, errors, and events

Conventions
Conventions
 ErrorCatalog
ErrorCatalog
 Webhooks
Webhooks
 Lifecycle
Lifecycle
 Conformance
Conformance
 DataModel
DataModel
 Arazzo
Arazzo

Scroll for all 7

Build 5

SDKs, sample code, and the tooling you integrate with

GitHubOrganization
GitHubOrganization
 ToolCrosswalk
ToolCrosswalk
 Packages
Packages
 SDKs
SDKs
 CLI
CLI

Access & Security 6

Authentication, authorization, and security posture

SecurityTxt
SecurityTxt
 Authentication
Authentication
 OAuthScopes
OAuthScopes
 DomainSecurity
DomainSecurity
 VulnerabilityDisclosure
VulnerabilityDisclosure
 Security
Security

Operate 4

Status, limits, changes, and where to get help

Support
Support
 ChangeLog
ChangeLog
 ChangeLog
ChangeLog
 RateLimits
RateLimits

Commercial 4

Pricing, plans, and the legal terms of use

Pricing
Pricing
 TermsOfService
TermsOfService
 PrivacyPolicy
PrivacyPolicy
 Plans
Plans

Company 1

The organization behind the API

Blog
Blog

Other 3

Properties that don't map to a standard resource type

APICatalog
APICatalog
 AgentCard
AgentCard
 Overlay
Overlay

Source (apis.yml)

apis.yml Raw ↑ 
name: Lacuna
description: 'Lacuna (lacuna.fm), operated by JOYLINK LTD, is an AI music creation platform that turns lyrics or a plain-text
  style description into complete songs with vocals, alongside lyrics writing, word-level timed lyrics (LRC/SRT/VTT), lyric
  video export, AI mastering, mashups, stem separation, album-cover art, MIDI tooling and sheet-music conversion, plus long-form
  AI radio for focus, sleep and ambience. Developers get a documented REST music-generation API (OpenAPI 3.1 published at
  /api/openapi.json), an official TypeScript SDK, a `lacuna` CLI, and an unusually complete agent surface: a hosted Streamable-HTTP
  MCP server at /mcp with an anonymous tools/list, an A2A JSON-RPC agent endpoint at /a2a with a published agent card, an
  RFC 9727 api-catalog, RFC 8414 / RFC 9728 OAuth discovery, an agent-oriented auth.md, an llms.txt, and a packaged Agent
  Skill. API access requires a Pro plan or above and is billed in credits per generation.'
url: https://lacuna.apievangelist.com/apis.yml
image: https://www.lacuna.fm/favicon-192x192.png
created: '2026-08-02'
modified: '2026-08-09'
specificationVersion: '0.21'
tags:
- AI Music
- Music Generation
- AI Song Generator
- AI Lyrics Generator
- Audio
- MIDI
- Songwriting
- Generative AI
- MCP Server
- Agent Skill
- A2A
- Developer Tools
apis:
- name: Lacuna MCP Server
  description: Hosted Model Context Protocol server (Streamable HTTP) at https://www.lacuna.fm/mcp, protocol 2025-06-18. initialize
    and tools/list answer anonymously and return real input schemas; tools/call requires an OAuth 2.0 access token with music:generate
    or a lyr_live_ API key. Three tools — generate_music, get_generation, list_models. A stdio sibling ships on npm as lacuna-mcp
    for local clients.
  humanURL: https://www.lacuna.fm/docs/mcp
  baseURL: https://www.lacuna.fm/mcp
  tags:
  - MCP Server
  - Generative AI
  - AI Music
  - Developer Tools
  properties:
  - type: MCPServer
    url: mcp/lacuna-mcp.yml
  - type: ToolCrosswalk
    url: mcp/lacuna-tool-crosswalk.yml
  - type: Documentation
    url: https://www.lacuna.fm/docs/mcp
- name: Lacuna A2A Agent
  description: Agent-to-Agent JSON-RPC endpoint at https://www.lacuna.fm/a2a advertising the "Lacuna Music" agent card at
    /.well-known/agent-card.json (protocolVersion 0.3.0). One skill, generate_music, which accepts a style description or
    a structured data part, runs asynchronously, and returns audio artifacts via tasks/get. Auth is required on every method;
    anonymous calls return 401 authentication_error.
  humanURL: https://www.lacuna.fm/docs/api
  baseURL: https://www.lacuna.fm/a2a
  tags:
  - A2A
  - Agent Skill
  - Generative AI
  - AI Music
  properties:
  - type: AgentCard
    url: a2a/lacuna-a2a.yml
  - type: Documentation
    url: https://www.lacuna.fm/docs/api
- aid: lacuna:lacuna-lacuna-music-api-api
  name: Lacuna Lacuna Music API API
  description: The Lacuna Music API API from Lacuna — 0 operation(s) for lacuna music api.
  humanURL: https://www.lacuna.fm/docs/api
  baseURL: https://www.lacuna.fm/api
  tags:
  - Lacuna Music API
  properties:
  - type: OpenAPI
    url: openapi/lacuna-lacuna-music-api-api-openapi.yml
  - type: Documentation
    url: https://www.lacuna.fm/docs/api
  - type: APIReference
    url: https://www.lacuna.fm/api/openapi.json
  - type: Webhooks
    url: asyncapi/lacuna-webhooks.yml
  - type: ErrorCatalog
    url: errors/lacuna-problem-types.yml
  - type: RateLimits
    url: rate-limits/lacuna-rate-limits.yml
- aid: lacuna:lacuna-music-api
  name: Lacuna Music API
  description: Music generation endpoints.
  humanURL: https://www.lacuna.fm/docs/api
  baseURL: https://www.lacuna.fm/api
  tags:
  - Music
  properties:
  - type: OpenAPI
    url: openapi/lacuna-music-api-openapi.yml
  - type: Documentation
    url: https://www.lacuna.fm/docs/api
  - type: APIReference
    url: https://www.lacuna.fm/api/openapi.json
  - type: Webhooks
    url: asyncapi/lacuna-webhooks.yml
  - type: ErrorCatalog
    url: errors/lacuna-problem-types.yml
  - type: RateLimits
    url: rate-limits/lacuna-rate-limits.yml
x-enrichment:
  date: '2026-08-09'
  status: enriched
  artifacts_added: 38
  pass: local-v1
maintainers:
- FN: JOYLINK LTD
  email: support@lacuna.fm
  url: https://github.com/JOYLINK-LTD/lacuna-toolkit
common:
- type: AgenticAccess
  url: agentic-access/lacuna-agentic-access.yml
- type: DeveloperPortal
  url: https://www.lacuna.fm/docs
- type: Documentation
  url: https://www.lacuna.fm/docs
- type: APIReference
  url: https://www.lacuna.fm/docs/api
- type: GettingStarted
  url: https://www.lacuna.fm/docs
- type: Support
  url: https://www.lacuna.fm/contact
- type: Blog
  url: https://www.lacuna.fm/blog
- type: GitHubOrganization
  url: https://github.com/JOYLINK-LTD
- type: Pricing
  url: https://www.lacuna.fm/pricing
- type: SignUp
  url: https://www.lacuna.fm/signin
- type: TermsOfService
  url: https://www.lacuna.fm/terms
- type: PrivacyPolicy
  url: https://www.lacuna.fm/privacy
- type: ChangeLog
  url: https://www.lacuna.fm/changelog
- type: ChangeLog
  name: Lacuna changelog (structured)
  url: changelog/lacuna-changelog.yml
- type: OpenAPI
  url: openapi/_original/lacuna-music-openapi-original.json
- type: LLMsTxt
  url: llms/lacuna-llms.txt
- type: WellKnown
  url: well-known/lacuna-well-known.yml
- type: SecurityTxt
  url: well-known/lacuna-security.txt
- type: APICatalog
  url: well-known/lacuna-api-catalog.json
- type: MCPServer
  url: mcp/lacuna-mcp.yml
- type: ToolCrosswalk
  url: mcp/lacuna-tool-crosswalk.yml
- type: AgentCard
  url: a2a/lacuna-a2a.yml
- type: AgentSkill
  url: skills/_index.yml
- type: Packages
  url: packages/lacuna-packages.yml
- type: SDKs
  url: packages/lacuna-packages.yml
- type: CLI
  url: cli/lacuna-cli.yml
- type: Authentication
  url: authentication/lacuna-authentication.yml
- type: OAuthScopes
  url: scopes/lacuna-scopes.yml
- type: Conventions
  url: conventions/lacuna-conventions.yml
- type: ErrorCatalog
  url: errors/lacuna-problem-types.yml
- type: Webhooks
  url: asyncapi/lacuna-webhooks.yml
- type: Lifecycle
  url: lifecycle/lacuna-lifecycle.yml
- type: Conformance
  url: conformance/lacuna-conformance.yml
- type: DomainSecurity
  url: security/lacuna-domain-security.yml
- type: VulnerabilityDisclosure
  url: security/lacuna-vulnerability-disclosure.yml
- type: Security
  url: https://www.lacuna.fm/.well-known/security.txt
- type: RateLimits
  url: rate-limits/lacuna-rate-limits.yml
- type: Plans
  url: plans/lacuna-plans.yml
- type: DataModel
  url: data-model/lacuna-data-model.yml
- type: Overlay
  url: overlays/lacuna-music-overlay.yaml
- type: Arazzo
  name: Generate a Lacuna track and collect the audio
  url: arazzo/lacuna-generate-and-collect.yml