Search your library
searchSearch the USER'S COLLECTION by title, creator, genre, or theme. Literal keyword match only - the query must actually appear in the item's title/creator/genre/theme text, or it returns nothing. Returns items they own with status, ratings, and for box sets, the list of contained albums. Use this to answer questions about what the user has. For generic, thematic, mood, or conceptual queries (e.g. "something about grief", "a film podcast") where the exact wording may not appear in any field, use search_library instead - it searches by meaning, not keyword.
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>",
"query": "<query>"
},
"name": "search"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| query | Yes | Search query (matches title, author/artist/director/creator, genres, or themes) | |
| filter | No | Filter by status or rating. Books: all, reading, finished, unread, abandoned, rated, unrated. Movies/shows: all, watching, watched, unwatched, abandoned, rated, unrated. Anime: also plan_to_watch, completed, saved, on_hold, dropped. Albums: all, listening, played, unheard, saved, rated, unrated. Games: all, playing, played, unplayed, saved, on_hold, abandoned, rated, unrated. | |
| media_type | Yes | Type of media to search |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| items | Yes | ||
| query | No | ||
| total | No |