Source: https://dinakar-rewind.docs.pageloop.ai/reference/mcp-tools/listening

# Listening

{/\* Generated by scripts/gen-mcp-reference.ts. Do not edit by hand; change the tool and run \`npm run docs:gen-mcp\`. \*/}

## `get_artist_details`

Detailed listening profile for one artist: stats, rank, top tracks and albums, similar artists, and a yearly play sparkline.

#### id (path, number, required)

Artist ID

#### include\_images (path, boolean)

Include 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\_images (path, boolean)

Include 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\_images (path, boolean)

Include artwork/poster image content blocks in the response. Default true. Set false to keep responses small. Defaults to `true`.

#### limit (path, number)

Number of albums to return Defaults to `10`.

#### page (path, number)

Page number for pagination Defaults to `1`.

#### period (path, 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.

#### date (path, string)

Optional: filter to a specific date (YYYY-MM-DD)

#### from (path, string)

Optional: start of date range (ISO 8601)

#### include\_images (path, boolean)

Include artwork/poster image content blocks in the response. Default true. Set false to keep responses small. Defaults to `true`.

#### include\_sparklines (path, 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`.

#### limit (path, number)

Number of artists to return Defaults to `10`.

#### page (path, number)

Page number for pagination Defaults to `1`.

#### period (path, 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`.

#### to (path, 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.

#### artist\_id (path, integer)

Filter to a single artist. Stable id from get\_artist\_details or get\_top\_artists. Composes with period and date filters.

#### artist\_name (path, 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.

#### date (path, string)

Optional: filter to a specific date (YYYY-MM-DD)

#### from (path, string)

Optional: start of date range (ISO 8601)

#### limit (path, number)

Number of tracks to return Defaults to `10`.

#### page (path, number)

Page number for pagination Defaults to `1`.

#### period (path, 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`.

#### to (path, string)

Optional: end of date range (ISO 8601)