> ## Documentation Index
> Fetch the complete documentation index at: https://docs.rewind.rest/llms.txt
> Use this file to discover all available pages before exploring further.

# Listening

> MCP tools for your Last.fm and Apple Music listening history.

## `get_album_details`

Get detailed information about a specific album by ID: artist, play count, track listing, cover art, and Apple Music link.

<ParamField path="id" type="number" required>
  Album ID
</ParamField>

<ParamField path="include_images" type="boolean">
  Include artwork/poster image content blocks in the response. Default true. Set false to keep responses small. Defaults to `true`.
</ParamField>

## `get_artist_details`

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

<ParamField path="id" type="number" required>
  Artist ID
</ParamField>

<ParamField path="include_images" type="boolean">
  Include artwork/poster image content blocks in the response. Default true. Set false to keep responses small. Defaults to `true`.
</ParamField>

## `get_listening_genres`

Get genre breakdown over time from Last.fm listening history, grouped by week/month/year.

<ParamField path="date" type="string">
  Optional: filter to a specific date (YYYY-MM-DD)
</ParamField>

<ParamField path="from" type="string">
  Optional: start of date range (ISO 8601)
</ParamField>

<ParamField path="group_by" type="string">
  Grouping period (default: month) One of: `week`, `month`, `year`. Defaults to `month`.
</ParamField>

<ParamField path="limit" type="number">
  Max genres to return -- rest grouped as "Other" (default 10) Defaults to `10`.
</ParamField>

<ParamField path="to" type="string">
  Optional: end of date range (ISO 8601)
</ParamField>

## `get_listening_stats`

Get overall listening statistics from Last.fm including total scrobbles, unique artists, albums, tracks, and daily average.

<ParamField path="date" type="string">
  Optional: filter to a specific date (YYYY-MM-DD)
</ParamField>

<ParamField path="from" type="string">
  Optional: start of date range (ISO 8601)
</ParamField>

<ParamField path="to" type="string">
  Optional: end of date range (ISO 8601)
</ParamField>

## `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.

<ParamField path="include_images" type="boolean">
  Include artwork/poster image content blocks in the response. Default true. Set false to keep responses small. Defaults to `true`.
</ParamField>

## `get_recent_listens`

Get recently scrobbled tracks from Last.fm, with top-N album covers and Apple Music resource links.

<ParamField path="date" type="string">
  Optional: filter to a specific date (YYYY-MM-DD)
</ParamField>

<ParamField path="from" type="string">
  Optional: start of date range (ISO 8601)
</ParamField>

<ParamField path="include_images" type="boolean">
  Include artwork/poster image content blocks in the response. Default true. Set false to keep responses small. Defaults to `true`.
</ParamField>

<ParamField path="limit" type="number">
  Number of recent tracks to return (default 10, max 50) Defaults to `10`.
</ParamField>

<ParamField path="page" type="number">
  Page number for pagination. Combine with limit to page through longer windows. Defaults to `1`.
</ParamField>

<ParamField path="to" type="string">
  Optional: end of date range (ISO 8601)
</ParamField>

## `get_top_albums`

Get top listened-to albums from Last.fm for a given time period, with top-N covers and Apple Music links.

<ParamField path="include_images" type="boolean">
  Include artwork/poster image content blocks in the response. Default true. Set false to keep responses small. Defaults to `true`.
</ParamField>

<ParamField path="limit" type="number">
  Number of albums to return Defaults to `10`.
</ParamField>

<ParamField path="page" type="number">
  Page number for pagination Defaults to `1`.
</ParamField>

<ParamField path="period" type="string">
  Time period for rankings One of: `7day`, `1month`, `3month`, `6month`, `12month`, `overall`. Defaults to `1month`.
</ParamField>

## `get_top_artists`

Get top listened-to artists for a time window, with top-N artist images and Apple Music links.

<ParamField path="date" type="string">
  Optional: filter to a specific date (YYYY-MM-DD)
</ParamField>

<ParamField path="from" type="string">
  Optional: start of date range (ISO 8601)
</ParamField>

<ParamField path="include_images" type="boolean">
  Include artwork/poster image content blocks in the response. Default true. Set false to keep responses small. Defaults to `true`.
</ParamField>

<ParamField path="include_sparklines" type="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`.
</ParamField>

<ParamField path="limit" type="number">
  Number of artists to return Defaults to `10`.
</ParamField>

<ParamField path="page" type="number">
  Page number for pagination Defaults to `1`.
</ParamField>

<ParamField path="period" type="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`.
</ParamField>

<ParamField path="to" type="string">
  Optional: end of date range (ISO 8601)
</ParamField>

## `get_top_tracks`

Top listened-to tracks for a time window, with top-N Apple Music links.

<ParamField path="artist_id" type="integer">
  Filter to a single artist. Stable id from get\_artist\_details or get\_top\_artists. Composes with period and date filters.
</ParamField>

<ParamField path="artist_name" type="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.
</ParamField>

<ParamField path="date" type="string">
  Optional: filter to a specific date (YYYY-MM-DD)
</ParamField>

<ParamField path="from" type="string">
  Optional: start of date range (ISO 8601)
</ParamField>

<ParamField path="limit" type="number">
  Number of tracks to return Defaults to `10`.
</ParamField>

<ParamField path="page" type="number">
  Page number for pagination Defaults to `1`.
</ParamField>

<ParamField path="period" type="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`.
</ParamField>

<ParamField path="to" type="string">
  Optional: end of date range (ISO 8601)
</ParamField>