Notification & Subscription Tools
MCP tools for reading and marking in-app notifications and querying your subscription plan.
Overview
Notifications are user-scoped: they go directly to your account regardless of workspace, so these tools do not take a workspace_id. The subscription tool likewise returns your account's plan and limit information.
Tools
list_notifications
Lists your in-app notifications (invites, scrape/campaign events), newest first. The response also includes the total unread count (unread_count).
Key parameters:
| Parameter | Type | Required | Description |
|---|---|---|---|
limit | number | No | Max rows (1–200, default 50) |
unread_only | boolean | No | If true, only unread notifications (default false) |
Say this to your AI: "Do I have any unread notifications? Summarize them if so."
mark_notifications_read
Marks specific notifications (notification_ids) or all unread ones (mark_all) as read. At least one of the two parameters must be provided.
Key parameters:
| Parameter | Type | Required | Description |
|---|---|---|---|
notification_ids | UUID array | No* | IDs of notifications to mark as read (min 1) |
mark_all | boolean | No* | If true, all unread notifications are marked |
*Either notification_ids or mark_all: true is required.
Say this to your AI: "After summarizing my notifications, mark them all as read."
get_my_subscription
Returns your Connfig plan: plan ID and name, subscription status, renewal date, feature flags (CRM, campaigns), and effective limits (with any account-level overrides applied): max workspaces, seats, places scraped per month, monthly mail sends, and the CRM record limit.
Key parameters: takes no parameters.
Say this to your AI: "Which plan am I on, when does my subscription renew, and what is my monthly mail limit?"
For live mail quota consumption, use get_mail_usage from Campaign Read Tools — this tool shows the limits, that one shows actual usage over the last 30 days.