musicbrainz-mcp
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| MUSICBRAINZ_OAUTH_CLIENT_ID | No | OAuth client ID for write tools | |
| MUSICBRAINZ_OAUTH_CLIENT_SECRET | No | OAuth client secret for write tools | |
| MUSICBRAINZ_OAUTH_REFRESH_TOKEN | No | OAuth refresh token for write tools |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": true
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| musicbrainz_lookupA | Fetch a single MusicBrainz entity (artist, release, recording, release-group, label, work, area, place, event, instrument, series, genre, url) by its MBID. Use |
| musicbrainz_searchA | Search a MusicBrainz entity type with a Lucene query and get back ranked matches with their MBIDs. Plain text matches the entity name; fielded Lucene also works, e.g. |
| musicbrainz_browseA | 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, or events at a place. This is the complete, paged set for a relationship (unlike search, which ranks fuzzy matches). Use |
| musicbrainz_cover_artA | 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. |
| musicbrainz_resolveA | 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 |
| musicbrainz_healthcheckA | 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. |
| musicbrainz_submit_tagsA | Apply user tags to a MusicBrainz entity on YOUR account (needs OAuth: MUSICBRAINZ_OAUTH_* with the |
| musicbrainz_submit_ratingA | Set YOUR rating for a MusicBrainz entity (needs OAuth: MUSICBRAINZ_OAUTH_* with the |
| musicbrainz_modify_collectionA | 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 |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 9 tools
Each tool has a clearly distinct purpose: search, lookup by MBID, browse relationships, resolve URLs, cover art, health check, and three separate write operations (tags, rating, collections). No two tools overlap in function.
All tools share the 'musicbrainz_' prefix and snake_case, and most are verb-led (browse, lookup, search, resolve, submit_tags, submit_rating, modify_collection). 'cover_art' and 'healthcheck' are nouns, creating a minor deviation from the verb-first pattern.
Nine tools is well-scoped for a MusicBrainz client, covering read operations (search, lookup, browse, resolve, cover art, health check) and user-modifying operations (tags, ratings, collections) without unnecessary bloat.
The core read workflows and common user write actions are covered. Minor gaps include no way to list a user's own collections and no entity creation/editing, but these are edge use cases for a typical music lookup agent.