← clify home · catalogue

musicbrainz API for agents (unofficial) — JSON over curl | clify

MusicBrainz (open music encyclopedia): browse genres, instruments, artists, release groups, statistics and relationship types from the public musicbrainz.org web pages and their JSON helper endpoints.

Host: musicbrainz.org. Call these verified read commands with plain curl; no install, key, or account. Use the public JSON API with plain curl. No install, key, account, or browser is needed. Example: curl 'https://clify-dev.netlify.app/sites.json'. Start with /search?q=weather, then call /abc/COMMAND. Responses are one JSON object. The hosted MCP and GitHub repo are also available.

Commands

list-genres

List all genres in MusicBrainz, with each genre's name and detail URL (the MBID is in the URL) Params: none

curl 'https://clify-dev.netlify.app/musicbrainz/list-genres'

get-genre

Get one genre: name, primary tag, relationships (parent genres, subgenres, fusions/influences) and its Wikipedia summary Params: id*

curl 'https://clify-dev.netlify.app/musicbrainz/get-genre'

get-wikipedia-extract

Get the cached Wikipedia summary (HTML) for a genre, instrument, artist or release group; wikipediaExtract is null when none is linked Params: entity_type*, id*

curl 'https://clify-dev.netlify.app/musicbrainz/get-wikipedia-extract'

list-instruments

List all instruments, each with its name, short description and detail URL (the MBID is in the URL) Params: none

curl 'https://clify-dev.netlify.app/musicbrainz/list-instruments'

get-instrument

Get one instrument: name, type, description, relationships (subtypes, parent type, related instruments) and Wikidata link Params: id*

curl 'https://clify-dev.netlify.app/musicbrainz/get-instrument'

list-instrument-artists

List artists credited with playing an instrument, with artist type, gender, area and credit (paginated) Params: id*, page

curl 'https://clify-dev.netlify.app/musicbrainz/list-instrument-artists'

list-instrument-releases

List releases featuring an instrument, with artist, format, tracks, country, date, label and catalog number (paginated) Params: id*, page

curl 'https://clify-dev.netlify.app/musicbrainz/list-instrument-releases'

list-instrument-recordings

List recordings featuring an instrument, with artist and length (paginated) Params: id*, page

curl 'https://clify-dev.netlify.app/musicbrainz/list-instrument-recordings'

list-entity-tags

List the user-applied tags (with vote counts and any linked genre) on an instrument, artist or release group Params: entity_type*, id*

curl 'https://clify-dev.netlify.app/musicbrainz/list-entity-tags'

get-artist

Get an artist's details: name, type, country, begin/end dates, area, genres and external links (relations: Discogs, Wikidata, etc.) Params: id*

curl 'https://clify-dev.netlify.app/musicbrainz/get-artist'

get-release-group

Get a release group (album/single): title, artist credit, type, first release date, genres, external links and its list of release versions Params: id*

curl 'https://clify-dev.netlify.app/musicbrainz/get-release-group'

list-release-group-releases

List every release version of a release group, with date, country, status, barcode, labels/catalog numbers and media formats Params: id*, offset

curl 'https://clify-dev.netlify.app/musicbrainz/list-release-group-releases?id=187935b5-a0a4-3e6f-9684-48b67a5190a1'

get-statistics

Get the database statistics overview: counts of artists, releases, recordings, labels, works, disc IDs, editors, etc. Params: none

curl 'https://clify-dev.netlify.app/musicbrainz/get-statistics'

get-country-statistics

Get per-country counts of artists, releases, labels, events and places, ranked Params: none

curl 'https://clify-dev.netlify.app/musicbrainz/get-country-statistics'

get-statistic-timeline

Get the historical time series for one statistic as a map of date -> value (e.g. artist or release count over time) Params: stat*

curl 'https://clify-dev.netlify.app/musicbrainz/get-statistic-timeline'

list-history-events

List MusicBrainz project milestones (date, title, description, blog link) shown on the statistics timeline Params: none

curl 'https://clify-dev.netlify.app/musicbrainz/list-history-events'

list-relationship-type-pairs

List the entity-type pairs that have relationship types (e.g. Artist-Instrument), each with a link to its relationship types Params: none

curl 'https://clify-dev.netlify.app/musicbrainz/list-relationship-type-pairs'

list-relationship-types

List the relationship types between two entity types (e.g. artist-instrument), with link phrases, description and documentation link Params: pair*

curl 'https://clify-dev.netlify.app/musicbrainz/list-relationship-types'