Add to list
Add titles to one of your custom lists.
MCP tool trakt_write → add_to_list
write Confirm
Adds the given titles to a list. Titles already on it come back as already_on_list and the call fails with an account-limit error when the list is full. If the list is public, other people see the change. Use list_lists to check the privacy first. By default you confirm each call; you can switch that off for this tool.
Parameters
| Name | Type | Description |
|---|---|---|
| list_id string required | string | List ID or slug from list_lists. |
| 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_list",
"arguments": {
"list_id": "list_8c41d2",
"items": "items"
}
}
}
}Example response
{
"content": [
{
"type": "text",
"text": "{ ... same JSON as structuredContent ... }"
}
],
"structuredContent": {
"added": {
"movies": 0,
"shows": 5
},
"already_on_list": 0,
"not_found": []
},
"isError": false
}