list_new_notifications
List notifications NEW since the caller's last-seen timestamp on the given channels.
Read-only tool.
List notifications NEW since the caller's last-seen timestamp on the given channels. Lighter than list_notifications for "what changed since I last looked?" sweeps. Pass updateLastSeen: true to advance the cursor so the next call only returns newer ones; pass false (or omit) to peek without consuming.
Input
| Property | Type | Required | Description |
|---|---|---|---|
channels | string[] | yes | Channel strings to read from. Examples: user/<userId>, workspace/<workspaceId>, project/<projectId>/<visibility>. min items 1 |
types | string[] | no | Optional notification type filter. |
updateLastSeen | boolean | no | When true, advance the last-seen cursor so future calls only return newer items. |
limit | number | no | Page size (1-50, default 20). min 1. max 50 |
cursor | string | no | Opaque cursor from a prior page. |
JSON Schema
{
"type": "object",
"properties": {
"channels": {
"type": "array",
"items": {
"type": "string"
},
"minItems": 1,
"description": "Channel strings to read from. Examples: `user/<userId>`, `workspace/<workspaceId>`, `project/<projectId>/<visibility>`."
},
"types": {
"type": "array",
"items": {
"type": "string"
},
"description": "Optional notification type filter."
},
"updateLastSeen": {
"type": "boolean",
"description": "When true, advance the last-seen cursor so future calls only return newer items."
},
"limit": {
"type": "number",
"minimum": 1,
"maximum": 50,
"description": "Page size (1-50, default 20)."
},
"cursor": {
"type": "string",
"description": "Opaque cursor from a prior page."
}
},
"required": [
"channels"
],
"additionalProperties": false
}