Skip to main content
Glama
chrischall

musicbrainz-mcp

by chrischall

Server Configuration

Describes the environment variables required to run the server.

NameRequiredDescriptionDefault
MUSICBRAINZ_OAUTH_CLIENT_IDNoOAuth client ID for write tools
MUSICBRAINZ_OAUTH_CLIENT_SECRETNoOAuth client secret for write tools
MUSICBRAINZ_OAUTH_REFRESH_TOKENNoOAuth 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

CapabilityDetails
tools
{
  "listChanged": true
}

Tools

Functions exposed to the LLM to take actions

NameDescription
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 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. Read-only. Data from MusicBrainz (https://musicbrainz.org), the open music encyclopedia.

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. artist:"Miles Davis" AND country:US, release:"Kind of Blue" AND format:Vinyl, or recording:"So What" AND dur:[540000 TO 560000]. Feed a returned MBID into musicbrainz_lookup for full detail. Read-only. Data from MusicBrainz (https://musicbrainz.org), the open music encyclopedia.

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 inc for extra detail and limit/offset to page (max 100/page). Read-only. Data from MusicBrainz (https://musicbrainz.org), the open music encyclopedia.

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 inc to include linked sub-entities. Read-only. Data from MusicBrainz (https://musicbrainz.org), the open music encyclopedia.

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 tag scope). Default vote: upvote adds the tags; downvote opposes them; withdraw removes your vote. Without confirm: true it returns a dry-run preview (the exact XML) and makes NO network call; with confirm: true it submits. Data from MusicBrainz (https://musicbrainz.org), the open music encyclopedia.

musicbrainz_submit_ratingA

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). Without confirm: true it returns a dry-run preview and makes NO network call; with confirm: true it submits. Data from MusicBrainz (https://musicbrainz.org), the open music encyclopedia.

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 collection scope). Get the collection MBID from its URL (musicbrainz.org/collection/). Without confirm: true it returns a dry-run preview and makes NO network call; with confirm: true it applies the change. Data from MusicBrainz (https://musicbrainz.org), the open music encyclopedia.

Prompts

Interactive templates invoked by user choice

NameDescription

No prompts

Resources

Contextual data attached and managed by the client

NameDescription

No resources

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/chrischall/musicbrainz-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server