Tools & Annotations
The complete list comes live from tools/list. Below are the most important concepts for working with the list/task tools.
Filters on list_list_items
Server-side filters save you from post-filtering and reduce the response size:
| Parameter | Effect |
|---|---|
state | open / done / all |
assigned_to_me | only items assigned to me (no get_me needed) |
due_within_days | due soon (including overdue) |
due_before | due before an ISO date |
sort | priority / due_date / created / modified |
compact | lean response (fewer tokens) |
json
{"name":"list_list_items",
"arguments":{"state":"open","assigned_to_me":true,"compact":true}}Useful dedicated tools
get_my_open_items— "What's on my plate?" (overdue → due → priority)complete_list_item/complete_list_items— check off (single/bulk)list_recent_changes— sync/polling: what has changed sincesinceget_metadata— valid status/priority/scope values
Annotations
Every tool carries behavior hints in tools/list, so that clients can allow read tools automatically and warn before destructive ones:
| Tool | Type |
|---|---|
list_list_items | read-only |
update_list_item | write · idempotent |
delete_list_item | destructive |
readOnlyHint, destructiveHint, idempotentHint, openWorldHint.
Pagination & compact
All list tools support compact:true. Paginated tools return has_more — after that, increase offset until has_more:false.