get_album_details
Get detailed information about a specific album by ID: artist, play count, track listing, cover art, and Apple Music link.
number
required
Album ID
boolean
Include artwork/poster image content blocks in the response. Default true. Set false to keep responses small. Defaults to
true.get_artist_details
Detailed listening profile for one artist: stats, rank, top tracks and albums, similar artists, and a yearly play sparkline.
number
required
Artist ID
boolean
Include artwork/poster image content blocks in the response. Default true. Set false to keep responses small. Defaults to
true.get_listening_genres
Get genre breakdown over time from Last.fm listening history, grouped by week/month/year.
string
Optional: filter to a specific date (YYYY-MM-DD)
string
Optional: start of date range (ISO 8601)
string
Grouping period (default: month) One of:
week, month, year. Defaults to month.number
Max genres to return — rest grouped as “Other” (default 10) Defaults to
10.string
Optional: end of date range (ISO 8601)
get_listening_stats
Get overall listening statistics from Last.fm including total scrobbles, unique artists, albums, tracks, and daily average.
string
Optional: filter to a specific date (YYYY-MM-DD)
string
Optional: start of date range (ISO 8601)
string
Optional: end of date range (ISO 8601)
get_listening_streaks
Get listening streak data from Last.fm — current consecutive days with scrobbles and the longest streak ever.
This tool takes no parameters.
get_now_playing
Get the track currently playing (or most recently scrobbled) on Last.fm.
boolean
Include artwork/poster image content blocks in the response. Default true. Set false to keep responses small. Defaults to
true.get_recent_listens
Get recently scrobbled tracks from Last.fm, with top-N album covers and Apple Music resource links.
string
Optional: filter to a specific date (YYYY-MM-DD)
string
Optional: start of date range (ISO 8601)
boolean
Include artwork/poster image content blocks in the response. Default true. Set false to keep responses small. Defaults to
true.number
Number of recent tracks to return (default 10, max 50) Defaults to
10.number
Page number for pagination. Combine with limit to page through longer windows. Defaults to
1.string
Optional: end of date range (ISO 8601)
get_top_albums
Get top listened-to albums from Last.fm for a given time period, with top-N covers and Apple Music links.
boolean
Include artwork/poster image content blocks in the response. Default true. Set false to keep responses small. Defaults to
true.number
Number of albums to return Defaults to
10.number
Page number for pagination Defaults to
1.string
Time 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.
string
Optional: filter to a specific date (YYYY-MM-DD)
string
Optional: start of date range (ISO 8601)
boolean
Include artwork/poster image content blocks in the response. Default true. Set false to keep responses small. Defaults to
true.boolean
When 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.number
Number of artists to return Defaults to
10.number
Page number for pagination Defaults to
1.string
Rolling 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.string
Optional: end of date range (ISO 8601)
get_top_tracks
Top listened-to tracks for a time window, with top-N Apple Music links.
integer
Filter to a single artist. Stable id from get_artist_details or get_top_artists. Composes with period and date filters.
string
Substring 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.
string
Optional: filter to a specific date (YYYY-MM-DD)
string
Optional: start of date range (ISO 8601)
number
Number of tracks to return Defaults to
10.number
Page number for pagination Defaults to
1.string
Rolling 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.string
Optional: end of date range (ISO 8601)