# io.github.cyanheads/musicbrainz-mcp-server (remote · musicbrainz.caseyjhand.com)

Search MusicBrainz artists, releases, works, labels; resolve ISRC/ISWC/barcode; fetch cover art.

- Trust score: 70/100 (medium)
- Change this week: +5
- Registry status: active
- Liveness: live
- Owner verified: no
- Last scored: 2026-08-04

## Components

- remote · `musicbrainz.caseyjhand.com`: 70/100 (this document), [markdown](https://verifymcp.io/servers/cyanheads-musicbrainz-mcp-server/musicbrainz.md), [page](https://verifymcp.io/servers/cyanheads-musicbrainz-mcp-server/musicbrainz)
- npm · `@cyanheads/musicbrainz-mcp-server`: 35/100, [markdown](https://verifymcp.io/servers/cyanheads-musicbrainz-mcp-server/cyanheads-musicbrainz-mcp-server.md), [page](https://verifymcp.io/servers/cyanheads-musicbrainz-mcp-server/cyanheads-musicbrainz-mcp-server)

## Channel facts

- Endpoint: `https://musicbrainz.caseyjhand.com/mcp`
- Transports: `streamable-http`
- Auth: `none`
- Version: `0.1.5`

## Trust breakdown

How this component scores in each security and reliability category. Every signal is checked automatically against the live server, and we only credit what we can confirm. Scores are 0–100 per category. Scoring method: https://verifymcp.io/docs/scoring (what has changed: https://verifymcp.io/docs/scoring/changelog)

Scored 2026-08-04.

- **Endpoint Security**: 66/100
  - The endpoint's TLS certificate is valid, in date, and uses a strong key.
  - Authorisation not fully verified: no authorisation is required to call this server, and 10 tool(s) never declared a destructiveHint. The MCP spec treats an absent hint as destructive by default, so we cannot call this surface safe.
  - HTTPS is enforced; there's no plaintext access path.
  - The HSTS (Strict-Transport-Security) header is present.
  - DNSSEC is configured correctly; the domain's records validate against the full chain to the root.
- **Transport & Reachability**: 100/100
  - Verified streamable-http transport via a live MCP handshake.
- **Schema Quality & AI Usability**: 69/100
  - AI-judged instruction clarity (excellent).
  - Context-footprint check failed: tool/resource definitions use about 1827 tokens (~182/item across 10 items; 10 tools + 0 resources), over budget; trim descriptions and params.
  - Usage-examples check failed: none of the tools include examples.
- **Stability & Change Management**: 30/100
  - Stability observed for 9 of 30 days with no destabilising changes; credit accrues until the full window elapses.
- **Tool Coverage**: 100/100
  - 100% of tools have a non-trivial description (not blank, and not just the tool's name).
  - 100% of tool parameters carry a description.
  - Structured output schemas are declared (100% of tools); any adoption earns full credit.
- **Capabilities**: 100/100
  - Implements a supported MCP spec version (2025-11-25); the latest is 2026-07-28.

## Install

### Claude

```bash
claude mcp add --transport http cyanheads-musicbrainz-mcp-server https://musicbrainz.caseyjhand.com/mcp
```

### Codex

```toml
[mcp_servers.cyanheads-musicbrainz-mcp-server]
url = "https://musicbrainz.caseyjhand.com/mcp"
```

### opencode

```json
{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "cyanheads-musicbrainz-mcp-server": {
      "type": "remote",
      "url": "https://musicbrainz.caseyjhand.com/mcp",
      "enabled": true
    }
  }
}
```

### OpenClaw

```bash
openclaw mcp add cyanheads-musicbrainz-mcp-server --url https://musicbrainz.caseyjhand.com/mcp --transport streamable-http
```

### Hermes

```yaml
mcp_servers:
  cyanheads-musicbrainz-mcp-server:
    url: "https://musicbrainz.caseyjhand.com/mcp"
```

### Other

```json
{
  "mcpServers": {
    "cyanheads-musicbrainz-mcp-server": {
      "type": "http",
      "url": "https://musicbrainz.caseyjhand.com/mcp"
    }
  }
}
```

The mcpServers block is a cross-client convention. Remote transports vary, so check your client's docs.

## Changelog

Every change recorded for this component, newest first. Days that predate change tracking, or that we cannot explain, say so: "we were watching and nothing happened" and "we were not watching" are different claims.

### 2026-08-04 (score 70, +1)

No change was recorded against any check on this day. Stability & Change Management went from 27 to 30. That category is still filling its 30-day observation window: 8 days of observed history at the previous scan, 9 at this one. The score rises as the window fills, whether or not the server changes.

### 2026-08-02 (score 69, +1)

No change was recorded against any check on this day. Stability & Change Management went from 20 to 23. That category is still filling its 30-day observation window: 6 days of observed history at the previous scan, 7 at this one. The score rises as the window fills, whether or not the server changes.

### 2026-07-31 (score 68, +2)

- [functional] We updated how we score, so this day's move reflects our rubric, not a change to the server

### 2026-07-30 (score 66, 0)

- [functional] We updated how we score, so this day's move reflects our rubric, not a change to the server

### 2026-07-29 (score 66, +1)

No change was recorded against any check on this day. Stability & Change Management went from 7 to 10. That category is still filling its 30-day observation window: 2 days of observed history at the previous scan, 3 at this one. The score rises as the window fills, whether or not the server changes.

### 2026-07-28 (score 65, +1)

No change was recorded against any check on this day. Stability & Change Management went from 3 to 7. That category is still filling its 30-day observation window: 1 days of observed history at the previous scan, 2 at this one. The score rises as the window fills, whether or not the server changes.

### 2026-07-27 (score 64, 0)

- [functional] We updated how we score, so this day's move reflects our rubric, not a change to the server

### 2026-07-26 (score 64)

First indexed and scored.

## MCP tools (10)

### `musicbrainz_search_entities` (~212 tokens)

musicbrainz-mcp-server: search entities

Full-text search across a MusicBrainz entity type (artist, release-group, release, recording, work, label) using a Lucene query string. Returns ranked matches with MBID, name/title, disambiguation, type, and a 0–100 relevance score (100 = exact). Starting point when resolving a name to an MBID — chain the returned MBID into the matching musicbrainz_get_* tool. Results are in MusicBrainz score-descending order. Supports field-scoped Lucene syntax (e.g. `artist:radiohead AND country:GB`).

Input parameters:

- `entityType` (string, required): Which entity type to search.
- `limit` (integer): Maximum results to return (1–100).
- `offset` (integer): Result offset for pagination (0-based).
- `query` (string, required): Lucene query string. Plain text matches names/titles; field scoping (e.g. `artist:`, `country:`, `tag:`) is supported.

Output parameters:

- `effectiveQuery` (string): The query string as sent to MusicBrainz.
- `entityType` (string): The entity type that was searched.
- `notice` (string): Guidance when zero results matched — how to broaden or correct the query.
- `results` (array): Ranked matches, in MusicBrainz score-descending order.
- `totalCount` (number): Total matches upstream before the limit/offset window.

### `musicbrainz_get_artist` (~197 tokens)

musicbrainz-mcp-server: get artist

Artist profile by MBID: type (person/group/…), country, life span, gender, area, aliases, tags/genres, plus the discography (release-groups) and band-membership / collaboration relationships and external links (Wikidata QID, Discogs, official site — surfaced as url-rels chainable to those servers). The 80% artist-detail call. Discography and relationships are capped at one page (25); for a prolific artist's complete release-group list, call musicbrainz_browse_entities with target_type=release-group and the artist link.

Input parameters:

- `inc_relationships` (boolean): Include band-membership / collaboration relationships and external links (url-rels).
- `inc_release_groups` (boolean): Include the discography (release-groups). Capped at one page; use browse for the full set.
- `mbid` (string, required): Artist MBID (36-character UUID).

Output parameters:

- `aliases` (array): Alternate names (may be empty).
- `area` (string): Associated area name. Omitted when unknown.
- `cap` (number): The one-page cap that was applied. Absent when not truncated.
- `country` (string): ISO country code. Omitted when unknown.
- `disambiguation` (string): Short qualifier distinguishing same-named artists. Omitted when absent.
- `externalLinks` (array): External resource links (url-rels) — Wikidata, Discogs, official site (may be empty).
- `gender` (string): Gender, for person-type artists. Omitted when unknown/inapplicable.
- `lifeSpan` (object): Birth/death or formation/dissolution span. Omitted when unknown.
- `mbid` (string): Artist MBID.
- `name` (string): Artist name.
- `notice` (string): How to fetch the complete discography when truncated.
- `relationships` (array): Band membership and collaboration relationships (may be empty).
- `releaseGroups` (array): Discography — release-groups (one page; may be empty or capped).
- `shown` (number): Number of release-groups returned. Absent when not truncated.
- `sortName` (string): Sortable name form. Omitted when absent.
- `tags` (array): Community tags/genres with vote counts (may be empty).
- `truncated` (boolean): True when the discography hit the one-page cap and more release-groups exist. Absent when the full set fit in one page.
- `type` (string): Artist type (Person, Group, Orchestra, …). Omitted when unknown.

### `musicbrainz_get_release_group` (~165 tokens)

musicbrainz-mcp-server: get release group

Release-group ("the album" above specific pressings) by MBID: primary type (Album/Single/EP) and secondary types (Live/Compilation), first-release date, artist credit, the list of releases (editions), tags/genres, and a cover-art availability flag from the WS/2 payload (use musicbrainz_get_cover_art for actual image URLs). The embedded releases list is capped at one page (25); for the complete set of editions, call musicbrainz_browse_entities with target_type=release and link.release-group. For a specific edition's tracklist, take a release MBID from the releases list and call musicbrainz_get_release.

Input parameters:

- `mbid` (string, required): Release-group MBID (36-character UUID).

Output parameters:

- `artistCredit` (array): Credited artists (may be empty).
- `artistCreditString` (string): Display string of the artist credit with join phrases.
- `cap` (number): The one-page cap that was applied. Absent when not truncated.
- `coverArt` (object): Whether cover art exists (availability stub from WS/2).
- `disambiguation` (string): Short qualifier. Omitted when absent.
- `firstReleaseDate` (string): Earliest release date across all editions. Omitted when absent.
- `mbid` (string): Release-group MBID.
- `notice` (string): How to fetch the complete list of editions when truncated.
- `primaryType` (string): Primary type (Album, Single, EP, Broadcast, Other). Omitted when absent.
- `releases` (array): Releases (editions) in this group (one page; may be empty or capped — use browse for all).
- `secondaryTypes` (array): Secondary types (Live, Compilation, Soundtrack, …). Omitted when none.
- `shown` (number): Number of releases returned. Absent when not truncated.
- `tags` (array): Community tags/genres (may be empty).
- `title` (string): Release-group title.
- `truncated` (boolean): True when the releases list hit the one-page cap and more editions exist. Absent when the full set fit in one page.

### `musicbrainz_get_release` (~112 tokens)

musicbrainz-mcp-server: get release

One edition's full detail by MBID: the tracklist (media → tracks → recordings with lengths and recording MBIDs), label + catalog number, barcode, country, release date, format, packaging, text representation (language/script), and a cover-art availability stub. Track lengths are rendered m:ss (stored as milliseconds upstream). For the actual cover image URLs, call musicbrainz_get_cover_art with this release MBID.

Input parameters:

- `mbid` (string, required): Release MBID (36-character UUID).

Output parameters:

- `artistCredit` (array): Credited artists (may be empty).
- `artistCreditString` (string): Display string of the artist credit with join phrases.
- `barcode` (string): Barcode (UPC/EAN). Omitted when absent; empty string upstream means "known to have none".
- `country` (string): Release country code. Omitted when absent.
- `coverArt` (object): Whether cover art exists (availability stub from WS/2).
- `date` (string): Release date. Omitted when absent.
- `disambiguation` (string): Short qualifier. Omitted when absent.
- `labelInfo` (array): Label / catalog-number pairings (may be empty).
- `language` (string): Text-representation language code. Omitted when absent.
- `mbid` (string): Release MBID.
- `media` (array): Media (discs) with their tracklists (may be empty).
- `packaging` (string): Packaging type (Jewel Case, Digipak, …). Omitted when absent.
- `releaseGroupId` (string): Parent release-group MBID — chain to musicbrainz_get_release_group. Omitted when absent.
- `script` (string): Text-representation script code. Omitted when absent.
- `status` (string): Release status (Official, Promotion, Bootleg, …). Omitted when absent.
- `title` (string): Release title.

### `musicbrainz_get_recording` (~160 tokens)

musicbrainz-mcp-server: get recording

Recording (a specific performance/track, distinct from the abstract work) by MBID: length, artist credits, ISRCs, the releases it appears on, the work(s) it performs (work-rels — chain to musicbrainz_get_work), and performance/production relationships (who played, produced, engineered, conducted — each with the role and the credited artist MBID). Relationships are capped at one page; for a heavily-covered recording call musicbrainz_browse_entities with target_type=recording and link.work.

Input parameters:

- `inc_relationships` (boolean): Include performance/production relationships (performers, producers, engineers) and work-rels.
- `mbid` (string, required): Recording MBID (36-character UUID).

Output parameters:

- `artistCredit` (array): Credited artists (may be empty).
- `artistCreditString` (string): Display string of the artist credit with join phrases.
- `disambiguation` (string): Short qualifier. Omitted when absent.
- `externalLinks` (array): External resource links (url-rels) (may be empty).
- `firstReleaseDate` (string): Earliest release date for this recording. Omitted when absent.
- `isrcs` (array): ISRCs assigned to this recording (may be empty).
- `length` (string): Recording length as m:ss. Omitted when unknown.
- `mbid` (string): Recording MBID.
- `relationships` (array): Performance/production relationships and work-rels (may be empty).
- `releases` (array): Releases this recording appears on (may be empty).
- `title` (string): Recording title.

### `musicbrainz_get_work` (~125 tokens)

musicbrainz-mcp-server: get work

Work (a composition — the song as written, distinct from any specific recording) by MBID: type, language(s), ISWCs (the work-level standard identifier), writer/composer/lyricist relationships (with the credited artist MBID), aliases, tags, and the recordings that perform it. The recording relationships are returned in full (the work lookup does not page them).

Input parameters:

- `inc_relationships` (boolean): Include writer/composer relationships, recording relationships, and external links.
- `mbid` (string, required): Work MBID (36-character UUID).

Output parameters:

- `aliases` (array): Alternate titles (may be empty).
- `disambiguation` (string): Short qualifier. Omitted when absent.
- `externalLinks` (array): External resource links (url-rels) (may be empty).
- `iswcs` (array): ISWCs assigned to this work (may be empty).
- `languages` (array): Lyrics languages (ISO codes; may be empty).
- `mbid` (string): Work MBID.
- `relationships` (array): Writer/composer/lyricist relationships and recording-rels — the complete set (may be empty).
- `tags` (array): Community tags/genres (may be empty).
- `title` (string): Work title.
- `type` (string): Work type (Song, Symphony, …). Omitted when unknown.

### `musicbrainz_get_label` (~124 tokens)

musicbrainz-mcp-server: get label

Label by MBID: type (Original Production, Reissue, Imprint, …), country, life span, label code (the LC number), area, aliases, tags, and external links (url-rels — Wikidata, Discogs, official site). A label's releases are a potentially huge linked set (a major label can have tens of thousands), so they are NOT embedded here — enumerate them with musicbrainz_browse_entities (target_type=release, link.label).

Input parameters:

- `mbid` (string, required): Label MBID (36-character UUID).

Output parameters:

- `aliases` (array): Alternate names (may be empty).
- `area` (string): Associated area name. Omitted when unknown.
- `country` (string): ISO country code. Omitted when unknown.
- `disambiguation` (string): Short qualifier. Omitted when absent.
- `externalLinks` (array): External resource links (url-rels) (may be empty).
- `labelCode` (number): Label code (LC number), without the "LC" prefix. Omitted when absent.
- `lifeSpan` (object): Founding/dissolution span. Omitted when unknown.
- `mbid` (string): Label MBID.
- `name` (string): Label name.
- `sortName` (string): Sortable name form. Omitted when absent.
- `tags` (array): Community tags/genres (may be empty).
- `type` (string): Label type. Omitted when unknown.

### `musicbrainz_lookup_identifier` (~191 tokens)

musicbrainz-mcp-server: lookup identifier

Resolve a standard identifier to MusicBrainz entities without a name search — the deterministic path when you already hold an ID. id_type=isrc → recordings (a recording-level code, often shared by several recordings); id_type=iswc → works (a composition-level code); id_type=barcode → releases (UPC/EAN). ISRC and ISWC hit dedicated exact endpoints; barcode is a Lucene search filter so results are ranked (exact match scores 100). The output kind field tells you which entity type came back.

Input parameters:

- `id_type` (string, required): Which standard identifier: isrc (recording), iswc (work), or barcode (release).
- `value` (string, required): The identifier value. ISRC e.g. "USRC17607839"; ISWC e.g. "T-010.140.236-1"; barcode e.g. "075678164125".

Output parameters:

- `result`: The resolved entities, discriminated by `kind` (recordings | works | releases).

### `musicbrainz_browse_entities` (~210 tokens)

musicbrainz-mcp-server: browse entities

Paginate the COMPLETE set of entities linked to a parent MBID — every release-group by an artist, every release on a label, every recording of a work, every release in a release-group. This is the only complete-enumeration path: the get_* tools embed at most one page (25) of any linked list, so use this tool whenever a linked set may exceed a page (a prolific artist, a major label with thousands of releases, a heavily-covered work). Provide exactly ONE link MBID matching a valid parent→child relationship for the target_type. Pages arbitrarily deep via offset; totalCount is the true upstream total.

Input parameters:

- `limit` (integer): Page size (1–100).
- `link` (object, required): Exactly one parent MBID. The valid key depends on target_type (see the description).
- `offset` (integer): Result offset for deep pagination (0-based).
- `target_type` (string, required): The entity type to enumerate (the children).

Output parameters:

- `cap` (number): The page size that was applied. Absent when not truncated.
- `entities` (array): This page of linked entities, in upstream order.
- `linkMbid` (string): The parent MBID that was browsed.
- `linkType` (string): The parent link type used (artist, label, release-group, recording, work, or area).
- `notice` (string): How to page further when results remain, or guidance when empty.
- `offset` (number): The offset used for this page.
- `shown` (number): Number of entities returned in this page. Absent when not truncated.
- `targetType` (string): The entity type that was enumerated.
- `totalCount` (number): True total number of linked entities upstream (the {type}-count field).
- `truncated` (boolean): True when more entities remain beyond this page (offset + shown < totalCount). Absent when the page is complete.

### `musicbrainz_get_cover_art` (~160 tokens)

musicbrainz-mcp-server: get cover art

Cover Art Archive images for a release or release-group MBID: front/back flags, image types, full-resolution URLs, and 250/500/1200px thumbnail URLs. Returns an empty image set (NOT an error) when the entity has no art — absence of art is information. Art is served at the release level; a release-group MBID resolves to a representative release's art automatically. URLs are linked, never rehosted — image copyright stays with the rights holders (only MusicBrainz core metadata is CC0).

Input parameters:

- `entity_type` (string): Whether the MBID is a release (default) or a release-group.
- `mbid` (string, required): Release or release-group MBID (36-character UUID).

Output parameters:

- `entityType` (string): Whether the MBID was treated as a release or release-group.
- `hasArt` (boolean): Whether any cover art exists for this entity.
- `images` (array): Cover-art images (empty when the entity has no art).
- `mbid` (string): The MBID that was queried.
- `notice` (string): Notice when no art exists for the entity.
- `representativeRelease` (string): For a release-group query, the release MBID whose art was returned. Omitted for direct release queries.

## Diagnostics

Captured diagnostic sections: TLS, DNSSEC, Authorisation, Transports. The full working is on the page: https://verifymcp.io/servers/cyanheads-musicbrainz-mcp-server/musicbrainz#diagnostics

## Score history

- 2026-08-04: 70
- 2026-08-03: 69
- 2026-08-02: 69
- 2026-08-01: 68
- 2026-07-31: 68
- 2026-07-30: 66
- 2026-07-29: 66
- 2026-07-28: 65
- 2026-07-27: 64
- 2026-07-26: 64

## Links

- Remote endpoint: https://musicbrainz.caseyjhand.com/mcp
- Repository: https://github.com/cyanheads/musicbrainz-mcp-server
- Changelog RSS feed: https://verifymcp.io/servers/cyanheads-musicbrainz-mcp-server/musicbrainz/changelog.xml
- Changelog JSON feed: https://verifymcp.io/servers/cyanheads-musicbrainz-mcp-server/musicbrainz/changelog.json
- HTML version of this page: https://verifymcp.io/servers/cyanheads-musicbrainz-mcp-server/musicbrainz