top_items
Retrieve a user's top artists, albums, or tracks over a chosen period to analyze listening trends and discover favorites.
Instructions
Get top artists, albums, or tracks for a Last.fm user over a selectable period. Pass a username unless the server has a local default.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"kind": "<kind>"
},
"name": "top_items"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| kind | Yes | Whether to return artists, albums, or tracks. | |
| limit | No | ||
| period | No | overall | |
| username | No | Last.fm username. Optional only when the server has a local default configured. |