get_notifications
Read-only
Fetch user notifications from AT Protocol (likes, reposts, follows, mentions, replies). Use countOnly to get unread badge count without loading full list.
Instructions
Retrieve notifications from AT Protocol (likes, reposts, follows, mentions, replies). Requires authentication (app password). Use countOnly: true to fetch only the unread badge count cheaply without loading the full list; use mark_notifications_seen to clear the unread state after processing. Subject to per-tool rate limiting.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | Max notifications per page (1–100, default 50). | |
| cursor | No | Opaque pagination cursor from the previous response cursor field; omit for the first page. | |
| seenAt | No | ISO 8601 timestamp; only return notifications that occurred after this time. Optional filter. | |
| countOnly | No | When true, return only the unread count and skip fetching the notification list (cheap badge-number path). |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| success | Yes | Whether the request succeeded. | |
| unreadCount | Yes | Number of unread notifications (always present). | |
| notifications | No | Notification entries. Present only when countOnly is false/absent. | |
| cursor | No | Opaque cursor for the next page. Present only when countOnly is false/absent. | |
| hasMore | No | True when a next page is available. Present only when countOnly is false/absent. | |
| seenAt | No | The timestamp up to which notifications have been seen. Present only when countOnly is false/absent. |