Tools
Listening
MCP tools for your Last.fm and Apple Music listening history.
get_artist_details
Detailed listening profile for one artist: stats, rank, top tracks and albums, similar artists, and a yearly play sparkline.
idrequiredArtist ID
include_imagesInclude artwork/poster image content blocks in the response. Default true. Set false to keep responses small. Defaults to true.
get_now_playing
Get the track currently playing (or most recently scrobbled) on Last.fm.
include_imagesInclude artwork/poster image content blocks in the response. Default true. Set false to keep responses small. Defaults to true.
get_top_albums
Get top listened-to albums from Last.fm for a given time period, with top-N covers and Apple Music links.
include_imagesInclude artwork/poster image content blocks in the response. Default true. Set false to keep responses small. Defaults to true.
limitNumber of albums to return Defaults to 10.
pagePage number for pagination Defaults to 1.
periodTime period for rankings One of: 7day, 1month, 3month, 6month, 12month, overall. Defaults to 1month.
get_top_artists
Get top listened-to artists for a time window, with top-N artist images and Apple Music links.
dateOptional: filter to a specific date (YYYY-MM-DD)
fromOptional: start of date range (ISO 8601)
include_imagesInclude artwork/poster image content blocks in the response. Default true. Set false to keep responses small. Defaults to true.
include_sparklinesWhen true (default), attach a sparkline (granularity + zero-filled play-count points) to each artist. Supported for period in {7day, 1month, 3month, 6month, 12month}. Set false to keep responses small. Defaults to true.
limitNumber of artists to return Defaults to 10.
pagePage number for pagination Defaults to 1.
periodRolling time period for rankings. Use for "lately"/"this week" style queries. Ignored when date/from/to is supplied. One of: 7day, 1month, 3month, 6month, 12month, overall. Defaults to 1month.
toOptional: end of date range (ISO 8601)
get_top_tracks
Top listened-to tracks for a time window, with top-N Apple Music links.
artist_idFilter to a single artist. Stable id from get_artist_details or get_top_artists. Composes with period and date filters.
artist_nameSubstring match against artist names (case-insensitive). Resolves to the highest-playcount match. Use only if no artist_id is available; passing both is a 400.
dateOptional: filter to a specific date (YYYY-MM-DD)
fromOptional: start of date range (ISO 8601)
limitNumber of tracks to return Defaults to 10.
pagePage number for pagination Defaults to 1.
periodRolling time period for rankings. Use for "lately"/"this week" style queries. Ignored when date/from/to is supplied. One of: 7day, 1month, 3month, 6month, 12month, overall. Defaults to 1month.
toOptional: end of date range (ISO 8601)