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 35 more developer resources.

🌐 Visit website 📡 Source on GitHub

62.0/100 strong ▬ flat Agent 57/100 agent ready saas Full breakdown ↓
scored 2026-09-03 · rubric v0.18.2

AccessFreemiumSelf serve⚡ Free to try

1 APIs 1 MCP Servers

AI Music Music GenerationAI Song GeneratorAI Lyrics GeneratorAudio MIDISongwritingGenerative AI MCP ServerAgentSkillA2A Developer Tools

What this lets a business do 1

Business capabilities this provider's published APIs can perform, derived from its own contracts. Browse all capabilities →

Content Origination & Production Management

BC-3700

Music

POST /v1/music/generations

Kin Score

Kin Score How this is scored →
scored 2026-09-03 · rubric v0.18.2

Composite quality — 62.0/100 · strong

Contract Quality 13.1 / 25

Developer Ergonomics 15.7 / 20

Access Clarity 15.3 / 20

Operational Transparency 8.2 / 13

Contract Governance 2.2 / 12

Discoverability 7.6 / 10

Agent readiness — 57/100 · agent ready

Machine-Readable Contract 18 / 18

Agentic Access Contract 10 / 10

Documented Reversibility 0 / 6

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 4 / 4

Consent & Bot Identity 0 / 3

A2A Agent Card 8 / 8

Dry-Run / Simulate Mode 0 / 4

Delegated User Identity 6 / 6

Protected Resource Metadata 5 / 5

Registration Without a Human 0 / 6

Agentic Commerce Surface 0 / 5

Improve this rating by publishing the missing artifacts — every area above can be raised, and the full rubric is at apis.io/rating/. Every facet and dimension name above is a link: it opens that measurement's own page — what it means, the exact checks that feed it, how the whole catalog distributes on it, and the providers at the top of it. 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. Submit an artifact on GitHub — free → Manage your own listing — the Influence plan, $499/mo →

Something on this page wrong about Lacuna? Report it → Free, always, and read by a human — corrections are worked from the queue daily. Agents can file the same report through the report_correction tool on the apis.io MCP.

APIs 4

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

MCP Servers 1

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

Rate Limits 1

Documented rate limits and quota policies.

Scopes 1

OAuth scopes governing access to this provider's APIs.

Lacuna Scopes

5 scopes · authorizationCode

5 scopes

SCOPES

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

LLMsTxt

WellKnown

MCPServer

AgentSkill

Design & Contract 7

Pagination, idempotency, versioning, errors, and events

Conventions

ErrorCatalog

Webhooks

Lifecycle

Conformance

DataModel

Arazzo

Scroll for all 7

Build 5

SDKs, sample code, and the tooling you integrate with

GitHubOrganization

ToolCrosswalk

Packages

SDKs

CLI

Access & Security 6

Authentication, authorization, and security posture

SecurityTxt

Authentication

OAuthScopes

DomainSecurity

VulnerabilityDisclosure

VulnerabilityDisclosure

Security

Security

Operate 4

Status, limits, changes, and where to get help

Support

ChangeLog

ChangeLog

RateLimits

Commercial 4

Pricing, plans, and the legal terms of use

Pricing

TermsOfService

PrivacyPolicy

Plans

Company 1

The organization behind the API

Blog

Blog

Other 4

Properties that don't map to a standard resource type

CapabilityMap

APICatalog

AgentCard

Overlay

Source (apis.yml)

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://raw.githubusercontent.com/api-evangelist/lacuna/refs/heads/main/apis.yml
deliveryModel:
  model: saas
  open_source: false
  commercial: true
  callable_host: true
  label: Hosted service · you call their endpoint
  confidence: high
  source:
  - openapi
  - pricing
  generated: '2026-08-28'
  method: derived
accessModel:
  pricing: freemium
  onboarding: self-serve
  trial: false
  try_now: true
  public: false
  label: Freemium · Self-serve signup
  confidence: high
  source:
  - plans
  - authentication
  - scopes
  - rate-limits
  - security
  generated: '2026-09-02'
  method: derived
image: https://www.lacuna.fm/favicon-192x192.png
created: '2026-08-02'
modified: '2026-08-09'
specificationVersion: '0.23'
tags:
- AI Music
- Music Generation
- AI Song Generator
- AI Lyrics Generator
- Audio
- MIDI
- Songwriting
- Generative AI
- MCP Server
- AgentSkill
- A2A
- Developer Tools
tags_raw:
- 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
  - AgentSkill
  - Generative AI
  - AI Music
  tags_raw:
  - 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: CapabilityMap
  url: capabilities/lacuna-capability-edges.yml
  name: Lacuna Business Capability Map
- 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

Work with this as data

Every provider here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for providers

9 MCP tools reach this

find_providersBrowse and filter every provider in the catalog.
get_provider_artifactsEvery artifact this provider publishes, grouped by type.
get_provider_operationsEvery operation across all of their OpenAPIs — one call instead of parsing every spec.
get_provider_toolsEvery MCP tool they ship, with the operation each wraps.
get_provider_evidenceHow each part of their score was established. Free — the basis for a claim should not sit behind it.
get_provider_ratingPRO — composite, band, trend and facet scores.
apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
resolveTurn a domain, URL or GitHub org into the provider it belongs to.
find_cohortsEvery scored population of providers in the catalog.

All 92 tools →

Call it yourself

curl for this page

This provider

curl "https://apis.io/api/v1/providers/lacuna"

All providers

curl "https://apis.io/api/v1/providers?limit=25"

Every operation they expose

curl "https://apis.io/api/v1/providers/lacuna/operations?limit=25"

How their score was established

curl "https://apis.io/api/v1/providers/lacuna/evidence"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no email required.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.