Skip to main content
Glama
musicbrainz-mcp

musicbrainz-mcp

by chrischall

musicbrainz-mcp

CI npm license

An MCP server for MusicBrainz, the open music encyclopedia. It gives Claude live access to MusicBrainz metadata — artists, releases, recordings, labels, works, and more — plus Cover Art Archive images, and (optionally) lets you submit your own tags, ratings, and collection edits.

Developed and maintained by AI (Claude Code). Use at your own discretion.

Tools

Read (no credentials required):

Tool

What it does

musicbrainz_search

Search any entity type with a Lucene query; returns ranked matches + MBIDs

musicbrainz_lookup

Look up an entity by MBID, with inc subqueries for linked data

musicbrainz_browse

List all entities linked to another (e.g. every release by an artist)

musicbrainz_cover_art

Cover Art Archive image URLs for a release / release-group

musicbrainz_resolve

Turn a pasted musicbrainz.org URL into its entity

musicbrainz_healthcheck

Verify connectivity and whether OAuth writes are configured

Write (OAuth, confirmed before sending):

Tool

What it does

musicbrainz_submit_tags

Apply user tags to an entity on your account

musicbrainz_submit_rating

Set your 0–100 rating for an entity

musicbrainz_modify_collection

Add/remove entities in one of your collections

Each write asks you to confirm before it makes any network call — see Confirmations.

Every read above takes a view, except musicbrainz_cover_art. It defaults to compact, which strips image and avatar URLs — a subtractive rule, so it cannot drop a field nobody knew was there; view: "full" returns MusicBrainz's payload untouched. musicbrainz_cover_art takes none on purpose: the image URLs are its answer, and stripping them would not shrink the response, it would empty it.

Related MCP server: musicbrainz-mcp-server

Install

This is a Node MCP server (stdio). Point your MCP host at it:

{
  "mcpServers": {
    "musicbrainz": {
      "command": "npx",
      "args": ["-y", "musicbrainz-mcp"]
    }
  }
}

Reads work immediately. MusicBrainz asks clients to make at most one request per second — the server throttles itself to stay within that limit, so large browses are paced automatically.

Enabling the write tools (optional)

  1. Register an application at musicbrainz.org/account/applications (redirect URI urn:ietf:wg:oauth:2.0:oob).

  2. Complete the OAuth flow with the tag, rating, and collection scopes to obtain a refresh token.

  3. Provide these via your MCP host's env (or a local .env):

MUSICBRAINZ_OAUTH_CLIENT_ID=...
MUSICBRAINZ_OAUTH_CLIENT_SECRET=...
MUSICBRAINZ_OAUTH_REFRESH_TOKEN=...

Confirmations

Every write asks you first. A client that can show a confirmation prompt (Claude Code) shows one, with the entity, tags / rating / collection change. A client that cannot (claude.ai, Claude Desktop) gets a two-step flow instead: the first call sends nothing and returns a confirmation-required preview — the exact XML for tags and ratings, the method and path for collections — plus a confirmToken; only a repeat of the same call with that token submits. A token acts once, and changing any argument between the two calls invalidates it.

variable

default

MCP_CONFIRM_MODE

ask-user

What a write does on a client that cannot show a confirmation prompt (claude.ai, Claude Desktop). ask-user: two steps — the first call does nothing and returns a preview plus a token, and the model must get your approval in chat before calling again with it. auto: the same two steps, but the model may use the token after reviewing the preview itself. refuse: writes are refused on such clients. A client that can show prompts (Claude Code) always gets the real prompt, unless MCP_CONFIRM_ELICITATION=off. An unrecognised value is treated as refuse.

MCP_CONFIRM_ELICITATION

on

off never shows a confirmation prompt, so every client gets the MCP_CONFIRM_MODE behaviour. Set it for a client that says it can show prompts but never does (the write hangs — opencode 2.0.x). Any other value is treated as on, with a warning on stderr.

MCP_CONFIRM_TTL_SECONDS

600

How long a token stays valid.

MCP_CONFIRM_SECRET

random per process

Signing key; set it only if tokens must survive a server restart.

Development

npm install
npm run build
npm test

See CLAUDE.md for architecture and docs/MUSICBRAINZ-API.md for the pinned API shapes.

License

MIT. Data from MusicBrainz, licensed under CC0 / CC BY-NC-SA.

Available Tools

9 tools
musicbrainz_browseBrowse MusicBrainz entities linked to anotherA
Read-onlyIdempotent

List all entities of one type directly linked to a given entity — e.g. every release by an artist (entity: "release", linkedBy: "artist", mbid: ), recordings on a release, releases in a collection (a private collection needs OAuth: MUSICBRAINZ_OAUTH_*), or events at a place. This is the complete, paged set for a relationship (unlike search, which ranks fuzzy matches). Use inc for extra detail and limit/offset to page (max 100/page). Read-only. Data from MusicBrainz (https://musicbrainz.org), the open music encyclopedia.

Inputs: mbid (required), entity (required), linkedBy (required), inc, +3 more.

musicbrainz_cover_artGet Cover Art Archive images for a releaseA
Read-onlyIdempotent

Fetch Cover Art Archive image metadata for a release or release-group MBID — front/back cover URLs, thumbnails, and image types. Returns the image URLs (you can open or download them); it does not embed the bytes. Errors clearly when no art exists for the MBID. Read-only. Data from MusicBrainz (https://musicbrainz.org), the open music encyclopedia.

Inputs: mbid (required), entity (required).

musicbrainz_healthcheckVerify MusicBrainz connectivityA
Read-onlyIdempotent

Confirm the MusicBrainz API is reachable (and our User-Agent accepted) by looking up a stable entity, and report whether the OAuth write path is configured. Reports {ok, reachable, oauth_configured} with a plain-English hint. Read-only.

Inputs: no named parameters.

musicbrainz_lookupLook up a MusicBrainz entity by MBIDA
Read-onlyIdempotent

Fetch a single MusicBrainz entity (artist, release, recording, release-group, label, work, area, place, event, instrument, series, genre, url) by its MBID. Use inc to pull linked sub-entities and relationships, e.g. inc: ["releases","release-groups"] on an artist, or ["recordings","labels"] on a release, or ["artist-credits","url-rels"] on most entities. Your own tags/ratings (inc: ["user-tags"], ["user-ratings"], …) need OAuth (MUSICBRAINZ_OAUTH_*). Read-only. Data from MusicBrainz (https://musicbrainz.org), the open music encyclopedia.

Inputs: mbid (required), entity (required), inc, view.

musicbrainz_modify_collectionAdd or remove entities in a MusicBrainz collectionA
DestructiveIdempotent

Add or remove entities (releases, artists, recordings, release-groups, works, labels, places, areas, events) in one of YOUR MusicBrainz collections (needs OAuth: MUSICBRAINZ_OAUTH_* with the collection scope). Get the collection MBID from its URL (musicbrainz.org/collection/). Asks the user to confirm first: a confirmation prompt where the client supports one; otherwise the first call returns a preview and a confirmToken, and only a repeat call with that token proceeds (see MCP_CONFIRM_MODE). Nothing is changed before confirmation. Data from MusicBrainz (https://musicbrainz.org), the open music encyclopedia.

Inputs: mbids (required), action (required), collection (required), entityType (required), +1 more.

musicbrainz_resolveResolve a MusicBrainz URL to its entityA
Read-onlyIdempotent

Turn a musicbrainz.org URL (e.g. https://musicbrainz.org/artist/ or /release-group/) into the underlying entity by extracting its type + MBID and looking it up. Handy when a user pastes a MusicBrainz link. Pass inc to include linked sub-entities. Read-only. Data from MusicBrainz (https://musicbrainz.org), the open music encyclopedia.

Inputs: url (required), inc, view.

musicbrainz_submit_ratingSubmit a user rating to MusicBrainzA
DestructiveIdempotent

Set YOUR rating for a MusicBrainz entity (needs OAuth: MUSICBRAINZ_OAUTH_* with the rating scope). Rating is 0–100 (MusicBrainz shows it as 1–5 stars in steps of 20; 0 removes your rating). Asks the user to confirm first: a confirmation prompt where the client supports one; otherwise the first call returns a preview and a confirmToken, and only a repeat call with that token proceeds (see MCP_CONFIRM_MODE). Nothing is sent before confirmation. Data from MusicBrainz (https://musicbrainz.org), the open music encyclopedia.

Inputs: mbid (required), entity (required), rating (required), confirmToken.

musicbrainz_submit_tagsSubmit user tags to MusicBrainzA
DestructiveIdempotent

Apply user tags to a MusicBrainz entity on YOUR account (needs OAuth: MUSICBRAINZ_OAUTH_* with the tag scope). Default vote: upvote adds the tags; downvote opposes them; withdraw removes your vote. Asks the user to confirm first: a confirmation prompt where the client supports one; otherwise the first call returns a preview and a confirmToken, and only a repeat call with that token proceeds (see MCP_CONFIRM_MODE). The preview shows the exact XML; nothing is sent before confirmation. Data from MusicBrainz (https://musicbrainz.org), the open music encyclopedia.

Inputs: mbid (required), tags (required), entity (required), vote, +1 more.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A4.3/5.0

    Scored across 9 tools

    Disambiguation4/5

    Each tool has a distinct purpose: lookup (single entity by MBID), browse (paged linked entities), search (Lucene ranking), resolve (URL parsing), cover_art, three OAuth writes, and healthcheck. There is mild overlap between lookup and resolve (resolve is essentially URL-extraction + lookup) and between browse and search, but descriptions clearly differentiate ranked-fuzzy vs complete-paged semantics.

    Naming Consistency4/5

    All tools use a consistent musicbrainz_ prefix and snake_case, which is highly predictable. The verb portion mixes styles slightly (submit_tags, submit_rating, modify_collection vs noun-ish lookup, browse, search, resolve, healthcheck), but this is readable and largely intuitive.

    Tool Count5/5

    Nine tools is well-scoped for a MusicBrainz client covering reads, search, resolution, cover art, and the three OAuth write paths. No tool feels redundant or gratuitous, and nothing is obviously missing from the count.

    Completeness4/5

    The surface covers the core read lifecycle (search, lookup, browse, resolve, cover art) plus the realistic write operations MusicBrainz allows via OAuth (tags, ratings, collections) and a healthcheck. Minor gaps remain (e.g. no explicit release-group or genre-centric browse helper), but agents can work around them with lookup/browse and inc.

    Maintenance

    ActivityActive
    ResponsivenessLimited data

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      B
      maintenance
      Search artists, releases, recordings, works, and labels; traverse relationships; resolve ISRC/ISWC/barcode; fetch cover art via MCP. STDIO or Streamable HTTP.
      157 npm
      2
      Apache 2.0
    • A
      license
      Not graded
      quality
      B
      maintenance
      An MCP server that enables searching books and authors, fetching editions, browsing subjects, and resolving cover images from Open Library.
      267 npm
      4
      Apache 2.0
    • A
      license
      Not graded
      quality
      B
      maintenance
      An MCP server for the Last.fm API, exposing artist, album, track, chart, and user data as read-only tools. Supports optional writes, auth, and experimental methods over stdio or HTTP.
      MIT