Musicbrainz MCP Server

@cyanheads/musicbrainz-mcp-server Search artists, releases, recordings, works, and labels; traverse relationships; resolve ISRC/ISWC/barcode; fetch cover art via MCP. STDIO or Streamable HTTP. 10 Tools • 1 Entity Resource • 1 Skill

Public Hosted Server: https://musicbrainz.caseyjhand.com/mcp

Overview

Open music metadata from MusicBrainz and the Cover Art Archive: artists, releases, recordings, works, and labels. Search by name, look up by MBID, ISRC, ISWC, or barcode, page through complete discographies, and fetch cover art.

Tools

Resources

The get_* tools provide normalized lookup views for tool-only clients. The entity resource has no list; find MBIDs with musicbrainz_search_entities.

Agent skill

musicbrainz-guide covers identity checks, edition selection, discographies, credits, artwork, and Lucene queries. It ships with npm, Docker, MCPB, and plugin installs, and is available through the MCP Skills extension and skill:// resources.

Capability reference

musicbrainz_search_entities tool

• One entityType per call (artist, release-group, release, recording, work, label) and a Lucene query with field scoping (artist:radiohead AND country:GB); positive integer limit (default 25, values above 100 clamp to 100 with a notice), offset for paging
• Returns the effective offset and upstream totalCount. Continuation uses offset + rows returned, including short pages. An empty page at or beyond a positive total reports exhaustion; an unexpectedly empty page before the total reports the discrepancy without suggesting a nonadvancing offset
• Search exposes only the first 500 matches. A page crossing that boundary is shortened with a notice; offsets of 500 or more fail as search_window_exceeded. Narrow the query or browse a linked set to reach further matches; totalCount remains the full upstream count
• Each hit carries mbid, name, and the raw 0–100 score in MusicBrainz order, plus type-specific fields such as artistCredit, isrcs, iswcs, and length. Release rows use status (Official, Bootleg, …); artist, release-group, work, and label subtypes use type. A whitespace-only query fails as blank_query
• Release-group hits also carry available secondaryTypes; recording hits carry available firstReleaseDate, including partial dates

musicbrainz_get_artist tool

• mbid, plus inc_release_groups and inc_relationships (both default true) to drop the heavier sub-resources
• Type, gender, country, area, lifeSpan, aliases, and tags, plus releaseGroups (one page), relationships (band membership, collaborations), and externalLinks (Wikidata, Discogs, official site)
• areaId can be passed to browse link.area; beginArea and endArea retain available MBID/name members. ipis and isnis preserve the catalog's identifier strings, including leading zeros

musicbrainz_get_release_group tool

• mbid only; returns primaryType, secondaryTypes, firstReleaseDate, artistCredit with artistCreditString, tags, and one page of releases (editions)
• externalLinks carries album-level identities such as Wikidata and Discogs masters
• coverArt (exists, count, front, back) comes from a live Cover Art Archive check; when that check fails the field is omitted with a notice, never reported as "no art"

musicbrainz_get_release tool

• mbid, media_offset (default 0), and media_limit (default 20, no maximum); returns ordered media with complete tracks per medium (position, title, length as m:ss, recordingId), labelInfo (label and catalogNumber), barcode, status, date, country, packaging, language/script, and releaseGroupId
• mediaTotal and trackTotal count all normalized media and track occurrences; upstream per-medium trackCount is preserved. mediaOffset identifies the window. When more media remain, truncated, shown, cap, and a notice give the next media_offset; empty end pages report exhaustion. The release resource retains the complete raw tracklist
• coverArt is the availability stub from the release record; call musicbrainz_get_cover_art for image URLs
• Tracks retain their own available artistCredit and artistCreditString, independently of release or recording credits. externalLinks belongs to the selected edition

musicbrainz_get_recording tool

• mbid, plus inc_relationships (default true) for performer, producer, and engineer credits, work links, recording-to-recording relationships such as samples and remixes, and external links
• Returns length, isrcs, artistCredit, firstReleaseDate, one upstream page of releases (up to 25), relationships, and externalLinks
• releaseAppearanceSummary reports shown, cap: 25, and completeness: a short present page is complete, a full or absent page without an exact count is unknown, and an exact upstream count exceeding the returned page proves truncated. totalCount is omitted when unknown; no count request is added. Enumerate appearances with musicbrainz_browse_entities (target_type=release, link.recording= , offset=0), because embedded and browse order may differ

musicbrainz_get_work tool

• mbid, plus inc_relationships (default true) for writer, composer, and lyricist credits, movements and arrangements, the recordings that perform it, and external links
• Returns type, languages, iswcs, aliases, and tags. Only the first 25 recording relationships are kept (other relationships and links are all kept); totalCount gives the full count, and truncated, shown, and cap appear when some were cut
• attributes preserves ordered type/value rows, including musical key, catalogue metadata and society work IDs. Repeated types and exact string values are retained, even with relationships disabled
• To list every recording of a work, browse recording by work, then call musicbrainz_get_recording for relationship attributes and dates
• Follow a relationships entry with targetType: "work" using its targetId in another musicbrainz_get_work call. direction distinguishes parent/child links; optional orderingKey preserves the upstream sequence key (including zero), and targetDisambiguation distinguishes arrangements. Relationships retain upstream array order, which need not match movement order

musicbrainz_get_label tool

• mbid only; returns type, country, area and areaId, ipis, isnis, lifeSpan, labelCode (the LC number without its prefix), aliases, tags, label relationships, and externalLinks
• Releases are not embedded; list them with musicbrainz_browse_entities (target_type=release, link.label)

musicbrainz_lookup_identifier tool

• id_type isrc → recordings, iswc → works, barcode → releases; a barcode is UPC/EAN digits and returns up to 25 ranked matches, each with a score
• ISRC accepts compact GBAYE9701274 or printed GB-AYE-97-01274, ignoring case and surrounding whitespace. ISWC accepts T-010.140.236-1 or T0101402361, with optional group punctuation, ignoring whitespace and case. Results echo the canonical compact ISRC or T-DDD.DDD.DDD-C ISWC; malformed codes fail before a request
• result.kind (recordings | works | releases) names the arm that came back; failures are invalid_identifier or identifier_not_found

musicbrainz_browse_entities tool

• target_type plus exactly one parent MBID in link; releaseGroup/release_group alias release-group. Positive integer limit defaults to 25; values above 100 clamp to 100 with a notice. Set MUSICBRAINZ_CLAMP_OVERSIZED_LIMITS=off to enforce maximum 100 for both search and browse
• Reports upstream totalCount; while more remain, truncated is set and a nonempty page gives the next offset using actual rows returned. Empty pages distinguish zero linked entities, exhaustion, and an unexpected empty page before the total. Clamp and paging guidance share one notice. Release rows use status; other entities use type
• A missing, extra, or malformed link fails as invalid_link, an unknown parent as entity_not_found. For ordered tracks of an edition use musicbrainz_get_release
• Rows retain available release-group secondaryTypes and recording firstReleaseDate. Album alone does not distinguish studio albums from live albums or compilations
• Optional type and status filters accept pipe-separated values with case and surrounding token whitespace normalized, echoed as type/status. Primary types union; primary and secondary categories intersect. Release-group-by-artist requires every sup