# Webpushr — how to use (mcp.ai)

Connect your Webpushr account and use 6 tools for notifications straight from your AI agent. Connect with your own API key. Webpushr enables websites to send push notification campaigns to all subscribers, segments, custom audiences, or individual subscribers and monitor campaign delivery.

## Option A — via MCP (recommended)
Remote MCP endpoint (HTTP, streamable): `https://api.mcp.ai/p_webpushr?ms=1787291460000`
Add it as a custom/remote MCP connector in your client (Claude, Cursor, VS Code…), then authenticate when prompted. Once connected, ask the agent to use the server's tools (e.g. `webpushr_get_notification_status`).

## Option B — via direct REST API
Base URL: `https://api.mcp.ai/api/webpushr`
Auth: `Authorization: Bearer sk_live_…` — create a workspace API key at https://mcp.ai/settings/api-keys
Discover endpoints: `GET https://api.mcp.ai/api/webpushr/_endpoints`

### Endpoints
- `POST https://api.mcp.ai/api/webpushr/get/notification/status` — Get delivery and engagement counts for a Webpushr notification campaign using its campaign ID.
  - body: { campaign_id: string }
- `POST https://api.mcp.ai/api/webpushr/get/subscriber/count` — Return lifetime and currently active subscriber counts for the connected Webpushr site.
- `POST https://api.mcp.ai/api/webpushr/send/notification/to/all` — Create or schedule a push notification campaign for every subscriber of the connected Webpushr site. This can notify the entire audience and should only be called with explicit user intent.
  - body: { icon?: string, name?: string, image?: string, title: string, message: string, send_at?: string, auto_hide?: integer, target_url: string, expire_push?: string, action_buttons?: object[] }
- `POST https://api.mcp.ai/api/webpushr/send/notification/to/attributes` — Create or schedule a push notification campaign for subscribers matching any supplied custom attribute key/value pair.
  - body: { icon?: string, name?: string, title: string, message: string, send_at?: string, auto_hide?: integer, attributes: object, target_url: string, expire_push?: string, action_buttons?: object[] }
- `POST https://api.mcp.ai/api/webpushr/send/notification/to/segments` — Create or schedule a push notification campaign for subscribers in one or more Webpushr segments. This sends to every subscriber in the selected segments and should only be called with explicit user i
  - body: { icon?: string, name?: string, image?: string, title: string, message: string, send_at?: string, auto_hide?: integer, target_url: string, expire_push?: string, segment_ids: integer[], action_buttons?: object[] }
- `POST https://api.mcp.ai/api/webpushr/send/notification/to/subscriber` — Send or schedule a push notification to one Webpushr subscriber ID. Use only when the intended recipient's subscriber ID is known.
  - body: { icon?: string, title: string, message: string, send_at?: string, auto_hide?: integer, target_url: string, expire_push?: string, subscriber_id: string, action_buttons?: object[] }

## Example prompts
- "What can I do in Webpushr?"
- "Show me a summary of my Webpushr account"

## More
- Page: https://mcp.ai/webpushr
- Agent spec (llms.txt): https://mcp.ai/webpushr/llms.txt
- Postman collection: https://mcp.ai/webpushr/postman.json