List watch events
list_watch_eventsList events matched by connection watches, oldest first, using cursor pagination and optional watch_id filtering to retrieve new activity since the last call.
Instructions
Events of this connection's watches (what they matched; list_watches shows the watches themselves), oldest first, kept 14 days. The first call without a cursor returns the oldest kept events. Pass the returned next_cursor on the next call to get only newer events (it is returned even when there are none). Optional watch_id narrows to one watch. Each event: event_id, watch_id, kind, account, message_id, thread_id, received_at; read the message with get_message(account, message_id).
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "list_watch_events"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | Most events returned. | |
| cursor | No | next_cursor of the previous call; omit for the oldest kept events. | |
| watch_id | No | Only events of this watch (from create_watch or list_watches). |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| events | No | ||
| has_more | No | ||
| next_cursor | No |