mcp-aoty
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| AOTY_BASE_URL | No | Unofficial Album of the Year API base URL | https://aoty.prigoana.com |
| AOTY_MIN_INTERVAL_MS | No | Minimum interval between upstream requests | 250 |
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 |
|---|---|
| get_server_versionA | Return the installed version of the mcp-aoty server. |
| get_attributionB | Return the required source attribution and upstream API references. |
| get_albumA | Fetch an album's detail, scores, tracks, reviews, and credits. Args: slug: Authoritative album URL slug, normally returned by search_albums. artist: Fuzzy fallback artist name; use only when a slug is unavailable. name: Fuzzy fallback album title; must be supplied with artist. minimal: Skip stats and credits when they are not needed. Artist-plus-name resolution is fuzzy: artist="Cassius", name="1999" returns the single "Cassius 1999" (id 1107653), not the LP 1999 (id 26857). Resolve with search_albums and pass its slug instead. |
| search_allB | Search albums, artists, and labels in one request. |
| search_albumsA | Search album releases and return their authoritative detail slugs. |
| search_artistsA | Search artist names and return artist profile slugs. |
| search_labelsB | Search record labels and return matching label profiles. |
| get_new_releasesA | List recently released albums, ordered by AOTY's release feed. Args: page: One-based page number for older releases. |
| get_new_singlesA | List recently released singles, ordered by AOTY's release feed. Args: page: One-based page number for older singles. |
| get_upcoming_releasesA | List announced upcoming album releases. Args: page: One-based page number for more upcoming releases. |
| get_popular_albumsA | List albums currently popular with the AOTY community. |
| get_popular_singlesA | List singles currently popular with the AOTY community. |
| get_anticipated_albumsA | List albums the AOTY community is most anticipating. |
| get_under_radar_albumsA | List highly regarded albums with lower mainstream visibility. |
| get_must_hear_albumsA | List AOTY's must-hear albums, optionally filtered by year or decade. Args: year: Release year to filter, or 0 to omit the filter. decade: Decade such as "1990s", or an empty string to omit the filter. page: One-based page number for more results. |
| get_critic_listsB | List publication and critic year-end lists, optionally for one year. Args: year: List year to filter, or 0 to return the default index. |
| get_critic_listA | Fetch the ranked albums in one critic or publication list. Args: slug: List slug returned by get_critic_lists. |
| get_music_newsA | List music-news stories from AOTY's selected feed. Args: page: One-based page number for older stories. feed_type: One of "newsworthy", "new", or "comment". |
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 18 tools
Most tools map clearly to distinct AOTY resources such as albums, singles, news, or critic lists, but the several album-list tools (popular, anticipated, under-the-radar, must-hear) share a similar "list albums" shape and could be confused despite different curation semantics. Search tools are cleanly separated by target type.
All tools follow a consistent get_ or search_ verb-plus-noun pattern in snake_case, with no mixed conventions or vague action verbs. Even the meta tools get_server_version and get_attribution fit the same naming scheme.
18 tools is on the heavier side, but each tool corresponds to a distinct AOTY feed or searchable entity, so the count is defensible for a comprehensive music-site server. It feels slightly over-scoped rather than bloated.
The server covers album browsing, searching, release timelines, singles, news, and critic lists well, but artist and label searches return slugs with no corresponding get_artist or get_label detail tool, creating dead ends. Singles also lack a detail lookup, leaving notable gaps despite strong core album coverage.