getTopTracks
Retrieve the current user's most-played Spotify tracks over a chosen time range (4 weeks, 6 months, or 1 year) with an optional result limit.
Instructions
Get the current user's top (most-played) tracks over a given time range. This is the closest thing Spotify exposes to listening statistics.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "getTopTracks"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | Maximum number of tracks to return (1-50) | |
| timeRange | No | Time range: short_term (~4 weeks), medium_term (~6 months), or long_term (~1 year). Default: medium_term. |