Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||
Capabilities
Features and capabilities supported by this server
| Capability | Details |
|---|---|
| tools | {
"listChanged": true
} |
| prompts | {
"listChanged": false
} |
| resources | {
"subscribe": false,
"listChanged": false
} |
| experimental | {} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| search_entities | Search for any MusicBrainz entity (artist, release, recording, label, work, release-group, area, event, instrument, place, series). Supports Lucene syntax. Example queries:
Entity hierarchy (IDs are NOT interchangeable):
Every ID returned is an MBID (UUID) bound to a specific entity type. An MBID from a release-group CANNOT be used as a release_id, and vice versa. Always track which entity type an ID belongs to and pass it to the matching tool. |
| browse_entities | Browse MusicBrainz entities linked to another entity, with paging. Useful for getting complete discographies, all releases on a label, etc. Common combinations:
Args: entity_type: What to list (releases, recordings, release-groups, artists, labels, works, events, places) linked_type: The entity you're browsing by (artist, label, recording, release, release_group, work, area, collection) linked_id: MBID of the linked entity limit: Results per page (max 100) offset: Paging offset |
| search_artists | Search for artists with specific filters. Prefer search_entities for simple name searches; use this when filtering by country, type, or gender. Args: name: Artist name country: ISO 3166-1 alpha-2 country code artist_type: 'person', 'group', 'orchestra', 'choir', 'character', 'other' gender: 'male', 'female', 'other', 'not applicable' limit: Max results (default 5) |
| search_releases | Search for releases with specific filters. Prefer search_entities for simple title searches; use this when filtering by artist, label, or barcode. Args: title: Release title artist: Artist name label: Label name barcode: UPC/EAN barcode limit: Max results (default 5) |
| get_artist_details | Get comprehensive info about an artist including aliases, tags, genres, and their discography (Release Groups) with MBIDs. Shows first 10 release groups; use get_artist_discography for the full paged list. |
| get_artist_discography | Get a paged discography (release groups) for an artist. Use this for complete discographies; get_artist_details only shows the first 10. Args: artist_id: The MBID limit: Max results (default 25) offset: Paging offset |
| get_release_details | Get tracklist with durations, barcode, and label for a specific release. Takes a release_id (a specific edition), NOT a release_group_id. To get tracks for an album concept, use get_album_tracks with a release_group_id. |
| get_recording_details | Get recording details: artist, duration, ISRCs, genres, and which releases (albums/singles) it appears on. |
| get_album_tracks | Fetches the tracklist with durations for a release group (album/EP/single). Takes a release_group_id (NOT a release_id). For a specific release's tracklist, use get_release_details instead. |
| get_release_group_details | Get details about a release group (the album/EP/single concept). A release group contains one or more releases (specific editions). Use get_release_details for a specific edition's tracklist and barcode. |
| get_work_details | Get details about a musical work (composers, lyricists, etc.). |
| get_area_details | Get details about a geographic area (country, city). |
| get_label_details | Get details about a record label including type, area, genres, and URLs. |
| lookup_by_barcode | Finds a release by its UPC/EAN barcode. |
| get_entity_relationships | Get relationships for any entity type (e.g., band members, producers, recording studios, Wikipedia links). Args: entity_type: artist, release, release-group, recording, work, label, area, place, event, instrument, series entity_id: The MBID (must match the entity_type) |
| get_cover_art_urls | Get cover art image URLs for a specific release (edition) from the Cover Art Archive. Takes a release_id, NOT a release_group_id. Returns URLs for front/back covers and thumbnails. |
| search_entities_fuzzy | Typo-tolerant fuzzy search. Tries an exact search first, then falls back to fuzzy matching if no results are found. Supports 'artist', 'release', 'recording', 'label', and 'work'. Use when the query may contain misspellings (e.g., 'Bjork' -> 'Björk'). |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |