List by status
get_by_statusGet items filtered by status. Books: unread, reading, finished, abandoned. Movies/shows: unwatched, watching, watched, abandoned. Anime: plan_to_watch, watching, completed, saved, on_hold, dropped (the movie words also work). Albums: unheard, listening, played, saved. Podcasts: want_to_listen, listening, caught_up, dropped. Games: unplayed, playing, played, saved, on_hold, abandoned. Pass status "all" for any media type to return items regardless of status.
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": {
"media_type": "<media_type>",
"status": "<status>"
},
"name": "get_by_status"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | Maximum number of results (default 50) | |
| status | Yes | Status to filter by, or "all" to return items regardless of status | |
| media_type | Yes | Type of media |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| items | Yes | ||
| query | No | ||
| total | No |