Version
READ

list_notifications

Read the notification centre of the creator the token acts for — every alert sent to them, newest first, with its class, where it points and whether it was read.

Answer "what has happened on my account that I have not looked at?". The Notifications Center is the sidebar entry with its unread count and the page at /notifications: every alert Subscriby sent the creator (a sale, a support backlog, a bot or channel that went silent, a billing or security notice, a pass window, an onboarding nudge). Each row is the same object GET /v1/me/notifications returns; meta.unread says how many are unread in all.

Requires ability

The token behind the MCP session must hold it, or the call is refused with TOKEN_MISSING_ABILITY.

Runs the same action as

The REST endpoint and this tool share one action, so validation, permissions and events are identical.

Annotations

Read-only

It reads and never changes anything.

Arguments

unreadbooleanoptional

`true` for entries not yet read, `false` for entries already read; omit for every entry.

classstringoptional

One class of alert, or omit for every class.

salessupportrecoverybillingsecuritypassesonboarding
querystringoptional

Words a title or body must contain; omit for every entry.

limitintegeroptional

Entries per page (1..100, default 25).

min1max100
pageintegeroptional

1-indexed page number.

min1

What it returns

{  "data": [    {      "id": "0b1f6e2a-7c3d-4e5f-8a9b-0c1d2e3f4a5b",      "class": "support",      "class_label": "Support",      "title": "Support backlog in Signals",      "body": "Three members are waiting for an answer.",      "route": "projects.inbox",      "params": { "projectId": "7f3d1c92-8b45-4e6a-9d21-5c8e0a4b6f13" },      "url": "https://app.subscriby.net/projects/7f3d1c92-8b45-4e6a-9d21-5c8e0a4b6f13/inbox",      "read": false,      "read_at": null,      "created_at": "2026-09-12T10:05:30Z"    }  ],  "meta": { "page": 1, "limit": 25, "total": 1, "has_more": false, "unread": 1 }}

How it fails

AUTHENTICATION_REQUIRED

no authenticated user on the request.

TOKEN_MISSING_ABILITY

token lacks account:read.

VALIDATION_FAILED

class is not one of the seven classes.

How is this guide?

Last updated on