Search titles
Find movies and shows by title and year, with Trakt IDs.
MCP tool trakt_read → search_titles
read
Returns matches for a text query, best match first, each with its Trakt ID, title, year and type. Use the ID in the write tools when a title has several matches. Returns at most one page of results per call.
Parameters
| Name | Type | Description |
|---|---|---|
| query string required | string | Title to look for. |
| type string | string | 'movie' or 'show'. Default: both. |
| year integer | integer | Release year, to separate titles with the same name. |
tools/call
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "trakt_read",
"arguments": {
"operation": "search_titles",
"arguments": {
"query": "query"
}
}
}
}Example response
{
"content": [
{
"type": "text",
"text": "{ ... same JSON as structuredContent ... }"
}
],
"structuredContent": {
"results": [
{
"type": "movie",
"trakt_id": 548210,
"title": "Past Lives",
"year": 2023
},
{
"type": "show",
"trakt_id": 401992,
"title": "Slow Horses",
"year": 2022
}
]
},
"isError": false
}