Metallum MCP
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| MA_USER_AGENT | No | User-Agent header | Mozilla/5.0 (compatible; metallum-mcp/1.0; personal use) |
| MA_CACHE_TTL_MS | No | Cache lifetime | 1800000 |
| MA_MIN_INTERVAL_MS | No | Minimum gap between requests | 3000 |
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": false
} |
| prompts | {
"listChanged": false
} |
| resources | {
"subscribe": false,
"listChanged": false
} |
| experimental | {} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| search_bandsA | Search bands by name and/or advanced filters (genre text, country, formation year range, lyrical themes, location, label). At least one filter is required. |
| search_albumsC | Search releases by title, band name, release year range, type, genre, label or country. |
| search_songsA | Search songs by title, band, release or lyrics text. Hits include lyrics_id for get_lyrics. |
| get_bandA | Band profile (country, location, status, formation year, genres, lyrical themes, label) plus lineup grouped by status (current, past, live, last_known, guest_session), with each member's roles and years. Use get_band_bio for the biography. |
| get_band_bioC | Full band biography / history text. |
| get_discographyB | A band's releases with id, type, release year and review stats. Optionally filter by type. |
| get_similar_bandsB | User-voted similar artists, ordered by match score (number of votes). |
| get_band_linksB | External links for a band (official site, Bandcamp, Spotify, socials, merch), by section. |
| get_band_reviewsA | Review list for a band's releases: release, score %, reviewer, date and review_url. Metadata only — pass review_url to get_review for the full text. |
| random_bandA | A random band from the archive, optionally from a coarse genre bucket. Genre-filtered picks re-roll until they match, so they can take up to ~30 seconds. |
| get_albumA | Release details (type, date, label, catalog no., format, review stats, notes), the tracklist (with per-track lyrics_id), and the lineup split into band / guest / staff. |
| get_other_versionsC | Other versions of a release: reissues, remasters, regional and format editions. |
| get_lyricsC | Lyrics for a song. |
| get_reviewA | Full text of a single review: title (with score), author, date and body. |
| get_artistA | Artist profile (real name, born/died, cause of death, origin) plus, by default, the full biography and trivia (two extra requests). |
| get_labelC | Record label profile: country, status, address, styles, founding date, sub-labels, parent. |
| browse_bandsB | List bands from the catalog by country, coarse genre, or first letter (first |
| browse_reviewsA | Reviews posted in a given month (defaults to the current month). Metadata only; use get_review for the text. |
| get_upcoming_releasesC | Upcoming releases, soonest first. |
| get_rip_artistsA | Metal Archives' R.I.P. list: deceased artists with band, date and cause of death. |
| list_countriesA | Country codes Metal Archives uses (for country filters and browse_bands). |
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 21 tools
Most tools have clearly distinct purposes, helped by descriptions that cross-reference each other (e.g. get_band vs get_band_bio, get_band_reviews vs browse_reviews). Mild overlap exists between browse_bands and search_bands, and the many band-centric getters could briefly confuse, but each targets a different facet.
Nearly all tools follow a consistent snake_case verb_noun pattern (get_, search_, browse_, list_). Only random_band deviates by omitting a verb, a minor inconsistency in an otherwise predictable scheme.
21 tools is on the high side for the typical 3-15 range, but the breadth of the Metallum domain (artists, bands, albums, songs, lyrics, reviews, labels, upcoming, RIP) justifies most of them. Each tool appears to cover a distinct retrieval need, so the count is slightly heavy but reasonable.
The read-only surface is comprehensive: artists, bands, albums, songs, lyrics, reviews, labels, countries, upcoming releases, and RIP lists are all covered. Minor gaps include no dedicated search_artists or search_labels, and get_artist does not explicitly return associated bands, but these are workable omissions.