get_album_details
Get detailed information about a specific album by ID: artist, play count, track listing, cover art, and Apple Music link.
Album ID
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.
Artist ID
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.
Optional: filter to a specific date (YYYY-MM-DD)
Optional: start of date range (ISO 8601)
Grouping period (default: month) One of:
week, month, year. Defaults to month.Max genres to return — rest grouped as “Other” (default 10) Defaults to
10.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.
Optional: filter to a specific date (YYYY-MM-DD)
Optional: start of date range (ISO 8601)
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.
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.
Optional: filter to a specific date (YYYY-MM-DD)
Optional: start of date range (ISO 8601)
Include artwork/poster image content blocks in the response. Default true. Set false to keep responses small. Defaults to
true.Number of recent tracks to return (default 10, max 50) Defaults to
10.Page number for pagination. Combine with limit to page through longer windows. Defaults to
1.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.
Include artwork/poster image content blocks in the response. Default true. Set false to keep responses small. Defaults to
true.Number of albums to return Defaults to
10.Page number for pagination Defaults to
1.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.
Optional: filter to a specific date (YYYY-MM-DD)
Optional: start of date range (ISO 8601)
Include artwork/poster image content blocks in the response. Default true. Set false to keep responses small. Defaults to
true.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 of artists to return Defaults to
10.Page number for pagination Defaults to
1.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.Optional: end of date range (ISO 8601)
get_top_tracks
Top listened-to tracks for a time window, with top-N Apple Music links.
Filter to a single artist. Stable id from get_artist_details or get_top_artists. Composes with period and date filters.
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.
Optional: filter to a specific date (YYYY-MM-DD)
Optional: start of date range (ISO 8601)
Number of tracks to return Defaults to
10.Page number for pagination Defaults to
1.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.Optional: end of date range (ISO 8601)