Tools & Annotations

Die vollständige Liste kommt live aus tools/list. Hier die wichtigsten Konzepte für den Umgang mit den Listen-/Aufgaben-Tools.

Filter auf list_list_items

Serverseitige Filter sparen das Nachfiltern und reduzieren die Antwortgröße:

Parameter	Wirkung
state	open / done / all
assigned_to_me	nur mir zugewiesene Items (kein get_me nötig)
due_within_days	bald fällige (inkl. überfällige)
due_before	fällig vor ISO-Datum
sort	priority / due_date / created / modified
compact	schlanke Antwort (weniger Tokens)

{"name":"list_list_items",
 "arguments":{"state":"open","assigned_to_me":true,"compact":true}}

Nützliche dedizierte Tools

• get_my_open_items — „Was steht bei mir an?" (überfällig → fällig → Priorität)
• complete_list_item / complete_list_items — abhaken (einzeln/Bulk)
• list_recent_changes — Sync/Polling: was hat sich seit since geändert
• get_metadata — gültige Status/Priorität/scope-Werte

Annotations

Jedes Tool trägt in tools/list Verhaltens-Hinweise, damit Clients Read-Tools automatisch erlauben und vor destruktiven warnen:

Tool	Art
list_list_items	read-only
update_list_item	write · idempotent
delete_list_item	destructive

readOnlyHint, destructiveHint, idempotentHint, openWorldHint.

Paginierung & compact

Alle List-Tools unterstützen compact:true. Paginierte Tools liefern has_more — danach offset erhöhen, bis has_more:false.