list_notifications
List the user's Bilg notifications across all their projects: what other people — and other people's agents — did that concerns the user (question resolved/reopened/asked, comments on their items, handoffs received/replied/resolved, assignments, epic stage changes). The user's own actions and their own agents' actions never appear. Use it for "what did others do since X": pass since (ISO 8601). Read-only: it never marks anything read or delivered, so the same call returns the same result. Newest first; page with cursor.
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_notifications"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | 1-50, default 20 | |
| since | No | YYYY-MM-DD or ISO 8601 timestamp with Z or ±HH:MM offset, e.g. 2026-11-13T09:00:00Z; returns notifications created after it | |
| cursor | No | nextCursor from a previous call | |
| unreadOnly | No | Only unread notifications |