Account Tools
The account behind the token: who is acting, which team the session is scoped to and what it may do.
The account behind the token: who is acting, which team the session is scoped to and what it may do. These tools answer that in one call and manage the account's own settings.
Tools
get_meGet MeREADlist_notificationsList NotificationsWRITEmark_all_notifications_readMark All Notifications ReadWRITEmark_notification_readMark Notification Readget_me
READDescribe the creator the token belongs to — plan and capabilities, the team the token is scoped to, every team held, connected accounts and alert destinations. Takes no input.
Learn who the agent is acting as before doing anything else: the creator, the team the token is scoped to (current_team.id, the id the other tools act in), every team they belong to, the platform plan and the capabilities it grants, the accounts linked on the connectors, and where alerts go. The payload is exactly what GET /v1/me returns.
Requires ability
The token behind the MCP session must hold it, or the call is refused with TOKEN_MISSING_ABILITY.
Runs the same actions as
The REST endpoint and this tool share one action, so validation, permissions and events are identical.
Annotations
It reads and never changes anything.
Arguments
This tool takes no arguments.
What it returns
{ "data": { "id": "2a91c4e7-6f38-4b52-8e0d-9c1a7b3f5d80", "name": "Ada Lovelace", "email": "[email protected]", "locale": "en", "email_verified": true, "plan": "growth", "capabilities": { "no_branding": true, "custom_handle": true, "time_limited_passes": true, "coupons": true, "free_plans": true, "teams": true, "disaster_recovery_prevention": true, "multi_connector": true }, "current_team": { "id": "a83f0d51-4c92-4b7e-8615-2fd9e70a3c86", "name": "Analytical Engines", "owner_user_id": "2a91c4e7-6f38-4b52-8e0d-9c1a7b3f5d80", "personal": true, "created_at": "2026-05-18T10:05:00Z" }, "teams": [{ "id": "a83f0d51-4c92-4b7e-8615-2fd9e70a3c86", "name": "Analytical Engines", "owner_user_id": "2a91c4e7-6f38-4b52-8e0d-9c1a7b3f5d80", "personal": true, "created_at": "2026-05-18T10:05:00Z" }], "identities": [{ "id": "0c2d8a7e-4b1f-4d3e-9a6b-2f5e8c1d7a90", "connector": "telegram", "purpose": "primary", "source": "handshake", "external_id": "123456789", "display_name": "Ada Lovelace", "username": "ada", "linked_at": "2026-09-12T10:05:00Z", "verified_at": "2026-09-12T10:05:00Z" }], "alert_destinations": [], "alert_destinations_default": true, "created_at": "2026-05-18T10:05:00Z" }}alert_destinations_default is true while the creator has written no destination: every class of alert then reaches their primary connected account, and the critical classes their email. plan is null without an active platform subscription.
How it fails
AUTHENTICATION_REQUIREDno authenticated user on the request.
TOKEN_MISSING_ABILITYtoken lacks account:read.
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
It reads and never changes anything.
Arguments
unreadbooleanoptional`true` for entries not yet read, `false` for entries already read; omit for every entry.
classstringoptionalOne class of alert, or omit for every class.
salessupportrecoverybillingsecuritypassesonboardingquerystringoptionalWords a title or body must contain; omit for every entry.
limitintegeroptionalEntries per page (1..100, default 25).
1max100pageintegeroptional1-indexed page number.
1What 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_REQUIREDno authenticated user on the request.
TOKEN_MISSING_ABILITYtoken lacks account:read.
VALIDATION_FAILEDclass is not one of the seven classes.
Mark every unread entry of the creator's notification centre as read in one call.
The bell's "Mark all as read" for agents: every unread entry is marked read in one statement and the tool answers how many it marked. Idempotent: a second call marks nothing and answers 0. Use it when the creator has caught up; to clear one entry use mark_notification_read.
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
Sending the same arguments twice changes nothing the second time.
Arguments
This tool takes no arguments.
What it returns
{ "data": { "marked": 3 }, "meta": {}}How it fails
AUTHENTICATION_REQUIREDno authenticated user on the request.
TOKEN_MISSING_ABILITYtoken lacks account:write.
Mark one entry of the creator's notification centre as read.
The bell's click for agents: one entry of the creator's notification centre is marked read, so the dashboard bell stops counting it. Idempotent: an entry already read keeps its first read_at. Take the id from list_notifications.
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
Sending the same arguments twice changes nothing the second time.
Arguments
notification_id*stringUUID of the entry to mark read, from `list_notifications`.
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": true, "read_at": "2026-09-12T10:35:00Z", "created_at": "2026-09-12T10:05:30Z" }, "meta": {}}How it fails
AUTHENTICATION_REQUIREDno authenticated user on the request.
TOKEN_MISSING_ABILITYtoken lacks account:write.
RESOURCE_NOT_FOUNDthe id is not one of this creator's entries.
How is this guide?
Access Code Tools
An access code is a pre-generated, single-use activation a creator hands out; redeeming it claims a pending subscription.
Analytics & Reports Tools
Every figure the creator dashboard renders is readable here, from revenue and churn to the transaction list, computed by the same service layer, so an agent and the dashboard never disagree.