io.github.cyanheads/musicbrainz-mcp-server

REMOTE · MUSICBRAINZ.CASEYJHAND.COM · 2 COMPONENTS · SCANNED AUG 3

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

Available components

remote · musicbrainz.caseyjhand.com 69 npm · @cyanheads/musicbrainz-mcp-server 35

+5 this week 69 69 Trust /100

Trust breakdown (6 categories)

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. How we score →

Endpoint Security66

The endpoint's TLS certificate is valid, in date, and uses a strong key. View diagnostics → Pass
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. See how to fix → View diagnostics → Unverified
HTTPS is enforced; there's no plaintext access path. View diagnostics → Pass
The HSTS (Strict-Transport-Security) header is present. View diagnostics → Pass
DNSSEC is configured correctly; the domain's records validate against the full chain to the root. View diagnostics → Pass

Transport & Reachability100

Verified streamable-http transport via a live MCP handshake. View diagnostics → Pass

Schema Quality & AI Usability69

AI-judged instruction clarity (excellent).Pass
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. See how to fix → Fail
Usage-examples check failed: none of the tools include examples. See how to fix → Fail

Stability & Change Management27

Stability observed for 8 of 30 days with no destabilising changes; credit accrues until the full window elapses.Partial

Tool Coverage100

100% of tools have a non-trivial description (not blank, and not just the tool's name).Pass
100% of tool parameters carry a description.Pass
Structured output schemas are declared (100% of tools); any adoption earns full credit.Pass

Capabilities100

Implements a supported MCP spec version (2025-11-25); the latest is 2026-07-28.Pass

Install

Add this component to your MCP client. Where a client-specific snippet is available, pick your client below and copy it straight into your config; otherwise use the connection detail shown.

remote · musicbrainz.caseyjhand.com

Claude Codex opencode OpenClaw Hermes Other

# add to Claude Code

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

# ~/.codex/config.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
    }
  }
}

# add to OpenClaw

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

# ~/.hermes/config.yaml

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

// mcp.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 we have recorded for this component, newest first. Security-relevant changes are always shown. ▲ marks a change for the better, ▼ a change for the worse; unmarked changes are neutral.

2 Aug 26 +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.
31 Jul 26 +2
- We updated how we score, so this day's move reflects our rubric, not a change to the server See what changed → functional
30 Jul 26 0
- We updated how we score, so this day's move reflects our rubric, not a change to the server See what changed → functional
29 Jul 26 +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.
28 Jul 26 +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.
27 Jul 26 0
- We updated how we score, so this day's move reflects our rubric, not a change to the server See what changed → functional
26 Jul 26 64

First indexed and scored.

Show 6 earlier entries Hide earlier entries

Diagnostics

Diagnostic detail from the automated scan of this channel: what the scanner observed at each step, so you can see exactly where a check passed or failed. It is informational only and never changes the trust score.

Captured 3 Aug 2026 · Probed https://musicbrainz.caseyjhand.com/mcp

TLS valid

Negotiated TLS 1.3 with TLS_AES_128_GCM_SHA256 .

Subject	Issuer	Valid from	Valid until	Key	Signature	Serial
CN=caseyjhand.com	CN=WE1,O=Google Trust Services,C=US	7 Jul 2026	5 Oct 2026	ECDSA 256	ECDSA-SHA256	5aad900eb2055a0b0ea55912ec19680c
SANs: caseyjhand.com, *.caseyjhand.com
CN=WE1,O=Google Trust Services,C=US (CA)	CN=GTS Root R4,O=Google Trust Services LLC,C=US	13 Dec 2023	20 Feb 2029	ECDSA 256	ECDSA-SHA384	7ff31977972c224a76155d13b6d685e3
CN=GTS Root R4,O=Google Trust Services LLC,C=US (CA)	CN=GlobalSign Root CA,OU=Root CA,O=GlobalSign nv-sa,C=BE	15 Nov 2023	28 Jan 2028	ECDSA 384	SHA256-RSA	7fe530bf331343bedd821610493d8a1b

DNSSEC secure

Validation of musicbrainz.caseyjhand.com. — Secure

Zone	DS	Keys	Algorithms	Outcome
.	trust_anchor	20326, 38696	8, 8	Verified
com.	present	19718	13	Verified
caseyjhand.com.	present	2371	13	Verified
musicbrainz.caseyjhand.com.				Verified address RRset verified with the apex keys

Authentication No authorisation required

The endpoint answered without asking for a token. Anyone who knows the URL can reach it.

Result	No authorisation required
HTTP status	200

Header	Value
strict-transport-security	max-age=63072000; includeSubDomains; preload
x-content-type-options	nosniff

Transports 2 probes

Transport	URL	Outcome	Status	Location
streamable-http	https://musicbrainz.caseyjhand.com/mcp	Verified	200
http (plaintext)	http://musicbrainz.caseyjhand.com/mcp	HTTPS enforced	301	https://musicbrainz.caseyjhand.com/mcp

MCP tools — 10 exposed · ~1,656 tokens

The tools this component advertises to a client, with an estimated token cost for each. Expand a tool to see its parameters and schema. The per-tool counts are indicative and are not scored directly; the schema's total context footprint is one signal in Schema Quality & AI Usability.

Tool Tokens

musicbrainz_browse_entities musicbrainz-mcp-server: browse entities ~210

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 Output Examples

Name	Type	Req	Description
limit	integer	—	Page size (1–100).
link	object	yes	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	yes	The entity type to enumerate (the children).

Name	Type	Req	Description
cap	number	—	The page size that was applied. Absent when not truncated.
entities	array	yes	This page of linked entities, in upstream order.
linkMbid	string	yes	The parent MBID that was browsed.
linkType	string	yes	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	yes	The offset used for this page.
shown	number	—	Number of entities returned in this page. Absent when not truncated.
targetType	string	yes	The entity type that was enumerated.
totalCount	number	yes	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.

No examples provided.

musicbrainz_get_artist musicbrainz-mcp-server: get artist ~197

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 Output Examples

Name	Type	Req	Description
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	yes	Artist MBID (36-character UUID).

Name	Type	Req	Description
aliases	array	yes	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	yes	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	yes	Artist MBID.
name	string	yes	Artist name.
notice	string	—	How to fetch the complete discography when truncated.
relationships	array	yes	Band membership and collaboration relationships (may be empty).
releaseGroups	array	yes	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	yes	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.

No examples provided.

musicbrainz_get_cover_art musicbrainz-mcp-server: get cover art ~160

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 Output Examples

Name	Type	Req	Description
entity_type	string	—	Whether the MBID is a release (default) or a release-group.
mbid	string	yes	Release or release-group MBID (36-character UUID).

Name	Type	Req	Description
entityType	string	yes	Whether the MBID was treated as a release or release-group.
hasArt	boolean	yes	Whether any cover art exists for this entity.
images	array	yes	Cover-art images (empty when the entity has no art).
mbid	string	yes	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.

No examples provided.

musicbrainz_get_label musicbrainz-mcp-server: get label ~124

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 Output Examples

Name	Type	Req	Description
mbid	string	yes	Label MBID (36-character UUID).

Name	Type	Req	Description
aliases	array	yes	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	yes	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	yes	Label MBID.
name	string	yes	Label name.
sortName	string	—	Sortable name form. Omitted when absent.
tags	array	yes	Community tags/genres (may be empty).
type	string	—	Label type. Omitted when unknown.

No examples provided.

musicbrainz_get_recording musicbrainz-mcp-server: get recording ~160

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 Output Examples

Name	Type	Req	Description
inc_relationships	boolean	—	Include performance/production relationships (performers, producers, engineers) and work-rels.
mbid	string	yes	Recording MBID (36-character UUID).

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

No examples provided.

musicbrainz_get_release musicbrainz-mcp-server: get release ~112

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 Output Examples

Name	Type	Req	Description
mbid	string	yes	Release MBID (36-character UUID).

Name	Type	Req	Description
artistCredit	array	yes	Credited artists (may be empty).
artistCreditString	string	yes	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	yes	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	yes	Label / catalog-number pairings (may be empty).
language	string	—	Text-representation language code. Omitted when absent.
mbid	string	yes	Release MBID.
media	array	yes	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	yes	Release title.

No examples provided.

musicbrainz_get_release_group musicbrainz-mcp-server: get release group ~165

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 Output Examples

Name	Type	Req	Description
mbid	string	yes	Release-group MBID (36-character UUID).

Name	Type	Req	Description
artistCredit	array	yes	Credited artists (may be empty).
artistCreditString	string	yes	Display string of the artist credit with join phrases.
cap	number	—	The one-page cap that was applied. Absent when not truncated.
coverArt	object	yes	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	yes	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	yes	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	yes	Community tags/genres (may be empty).
title	string	yes	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.

No examples provided.

musicbrainz_get_work musicbrainz-mcp-server: get work ~125

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 Output Examples

Name	Type	Req	Description
inc_relationships	boolean	—	Include writer/composer relationships, recording relationships, and external links.
mbid	string	yes	Work MBID (36-character UUID).

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

No examples provided.

musicbrainz_lookup_identifier musicbrainz-mcp-server: lookup identifier ~191

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 Output Examples

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

Name	Type	Req	Description
result	—	yes	The resolved entities, discriminated by `kind` (recordings \| works \| releases).

No examples provided.

musicbrainz_search_entities musicbrainz-mcp-server: search entities ~212

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 Output Examples

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

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

No examples provided.

On this page

Handy links

Scoring key

80+ high trust
60–79 medium
below 60 low

How we score

Score history · last 30 days

26 Jul 3 Aug

Day	Score
26 Jul	64
27 Jul	64
28 Jul	65
29 Jul	66
30 Jul	66
31 Jul	68
1 Aug	68
2 Aug	69
3 Aug	69