Add to watchlist
Add movies and shows to your watchlist in one call.
MCP tool trakt_write → add_to_watchlist
write
Adds the given titles to your watchlist. A show on its own adds just the show. Titles already on the watchlist are counted, not added twice, and titles Trakt cannot match come back in not_found. The call fails with an account-limit error if the watchlist is full. It reaches no one and remove_from_watchlist undoes it, so it needs no confirmation.
Parameters
| Name | Type | Description |
|---|---|---|
| items array required | array | Titles to change. Each item is an object: type ('movie', 'show', 'season' or 'episode'), title and year, or trakt_id from search_titles. Seasons and episodes also take season and episode numbers. add_to_history also takes watched_at, rate_titles takes rating. |
tools/call
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "trakt_write",
"arguments": {
"operation": "add_to_watchlist",
"arguments": {
"items": [
{
"type": "movie",
"title": "Past Lives",
"year": 2023
},
{
"type": "show",
"title": "Slow Horses",
"year": 2022
},
{
"type": "movie",
"title": "Perfect Days",
"year": 2023
}
]
}
}
}
}Example response
{
"content": [
{
"type": "text",
"text": "{ ... same JSON as structuredContent ... }"
}
],
"structuredContent": {
"added": {
"movies": 2,
"shows": 1
},
"already_on_watchlist": 0,
"not_found": []
},
"isError": false
}