Tmp.J1Z8MraaKa

Data & APIs

Search and browse the MusicBrainz music encyclopedia (artists, releases, recordings, labels, works), fetch Cover Art Archive images, resolve musicbrainz.org URLs, and — with OAuth configured — submit your own tags, ratings, and collection edits. Use when the user asks about music metadata, discographies, album/artist/recording details, MBIDs, cover art, or wants to tag/rate music on MusicBrainz.

Install

openclaw skills install musicbrainz-mcp

MusicBrainz

This server exposes the MusicBrainz /ws/2 API and the Cover Art Archive as MCP tools. Reads need no credentials; writes need OAuth (see the repo README).

Picking the right tool

  • Find something by namemusicbrainz_search with entity + a Lucene query. Plain text matches the name; fielded queries work too (artist:"Miles Davis" AND country:US). Returns MBIDs.
  • Get full detail for a known MBIDmusicbrainz_lookup with entity + mbid. Add inc for linked data, e.g. ["releases","release-groups"] on an artist, ["recordings","labels"] on a release, ["url-rels","tags"] on most entities.
  • Enumerate a relationshipmusicbrainz_browse: every release by an artist (entity:"release", linkedBy:"artist", mbid:<artist>), recordings on a release, releases in a collection, etc. This is the complete paged set (max 100/page), unlike search's fuzzy ranking.
  • Cover artmusicbrainz_cover_art with a release or release-group MBID. Returns image URLs (front/back/thumbnails); errors clearly when none exist.
  • A pasted musicbrainz.org linkmusicbrainz_resolve.
  • Check it's workingmusicbrainz_healthcheck.

Typical flow

Search to get an MBID, then lookup/browse for detail:

  1. musicbrainz_search { entity: "artist", query: "Radiohead" } → MBID
  2. musicbrainz_browse { entity: "release-group", linkedBy: "artist", mbid: <MBID>, limit: 100 } → discography
  3. musicbrainz_cover_art { entity: "release-group", mbid: <RG-MBID> } → album art

Writes (OAuth, confirm-gated)

musicbrainz_submit_tags, musicbrainz_submit_rating, and musicbrainz_modify_collection modify the user's own MusicBrainz account. Each returns a dry-run preview unless called with confirm: true — show the preview to the user and only re-call with confirm: true after they approve. They require MUSICBRAINZ_OAUTH_* to be configured.

Notes

  • MusicBrainz limits clients to ~1 request/second; the server paces itself, so a big browse may take a few seconds — that's expected, not an error.
  • Entity types: area artist event genre instrument label place recording release release-group series work url.