Create list
Create a custom list with a name, a description and a privacy setting.
MCP tool trakt_write → create_list
write Confirm
Creates an empty personal list. Privacy is 'private' unless you set it, and 'friends', 'link' or 'public' make the list visible to other people. The call fails with an account-limit error when you are at your list limit. By default you confirm each call; you can switch that off for this tool.
Parameters
| Name | Type | Description |
|---|---|---|
| name string required | string | Name of the list. |
| description string | string | Short description. |
| privacy string | string | 'private', 'link', 'friends' or 'public'. Default: 'private'. |
tools/call
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "trakt_write",
"arguments": {
"operation": "create_list",
"arguments": {
"name": "Jane Doe"
}
}
}
} Example response
{
"content": [
{
"type": "text",
"text": "{ ... same JSON as structuredContent ... }"
}
],
"structuredContent": {
"list_id": "cozy-autumn",
"name": "Cozy autumn",
"privacy": "private",
"item_count": 0
},
"isError": false
}