# Pushover — how to use (mcp.ai)

Connect your Pushover account and use 29 tools for notifications straight from your AI agent. Connect with your own API key. Pushover is a service that enables real-time notifications to your devices through simple API integration.

## Option A — via MCP (recommended)
Remote MCP endpoint (HTTP, streamable): `https://api.mcp.ai/p_pushover?ms=1787295720000`
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. `pushover_cancel_receipt_retries`).

## Option B — via direct REST API
Base URL: `https://api.mcp.ai/api/pushover`
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/pushover/_endpoints`

### Endpoints
- `POST https://api.mcp.ai/api/pushover/cancel/receipt/retries` — Tool to cancel further retries for an emergency-priority message before its expiry. Use when you no longer want Pushover to keep attempting delivery of an urgent notification.
  - body: { token: string, receipt: string }
- `POST https://api.mcp.ai/api/pushover/cancel/retries/by/tag` — Tool to cancel retries for all active emergency-priority Pushover messages matching a specific tag. Use after sending emergency messages when you want to stop further retries for a given tag.
  - body: { tag: string, token: string }
- `POST https://api.mcp.ai/api/pushover/client/ack/delete/up/to/id` — Tool to delete/acknowledge device messages up to a specific message ID. Use when you want to clear all messages up to a known ID; call after retrieving the latest message ID.
  - body: { secret: string, message: integer, device_id: string }
- `POST https://api.mcp.ai/api/pushover/client/fetch/messages` — Tool to download pending messages for a registered device. Use after device registration to retrieve messages queued server-side.
  - body: { secret: string, device_id: string }
- `POST https://api.mcp.ai/api/pushover/client/login` — Tool to authenticate a Pushover user by email and password. Use when you need to obtain a user key and session secret. Include twofa code if prompted by a prior HTTP 412 response.
  - body: { email: string, twofa?: string, password: string }
- `POST https://api.mcp.ai/api/pushover/client/realtime/websocket` — Tool to establish a secure WebSocket connection for real-time message notifications. Use after obtaining device ID and secret to receive instant push events.
  - body: { secret: string, timeout?: integer, device_id: string }
- `POST https://api.mcp.ai/api/pushover/client/register/device` — Tool to register an Open Client desktop device. Use when you have a session secret from users/login to obtain a device ID.
  - body: { os?: string, name: string, secret: string }
- `POST https://api.mcp.ai/api/pushover/get/app/icon/image` — Tool to fetch an application icon PNG by icon identifier. Use when you need to retrieve and cache the Pushover app icon image.
  - body: { icon: string }
- `POST https://api.mcp.ai/api/pushover/get/app/limits` — Tool to retrieve the current monthly message limit, remaining messages, and reset time for a Pushover application. Use when monitoring your monthly quota before sending messages.
  - body: { token: string }
- `POST https://api.mcp.ai/api/pushover/get/app/token` — Tool to fetch stored Pushover application API token. Use when supplying credentials to other Pushover actions securely.
  - body: { token?: string }
- `POST https://api.mcp.ai/api/pushover/get/receipt/status` — Tool to poll the status of an emergency-priority notification receipt. Use after sending an emergency notification to check its delivery and acknowledgment. Use when you have the `receipt` from an eme
  - body: { token: string, receipt: string }
- `POST https://api.mcp.ai/api/pushover/get/team/api/token` — Tool to fetch stored Pushover for Teams API token. Use when supplying team credentials to other Pushover Teams actions securely.
  - body: { token?: string }
- `POST https://api.mcp.ai/api/pushover/glances/update` — Tool to update a user's Glances widget data without sending a notification. Use after preparing glance data fields: title, text, subtext, count, or percent.
  - body: { text?: string, user: string, count?: integer, title?: string, token: string, device?: string, percent?: integer, subtext?: string }
- `POST https://api.mcp.ai/api/pushover/group/add/user` — Tool to add an existing Pushover user to a delivery group. Use when you need to include a user in a group by their user key.
  - body: { memo?: string, user: string, token: string, device?: string, group_key: string }
- `POST https://api.mcp.ai/api/pushover/group/create` — Tool to create a new Delivery Group. Use when you need to group multiple recipients under one group key before sending notifications.
  - body: { name: string, token: string }
- `POST https://api.mcp.ai/api/pushover/group/disable/user` — Tool to temporarily disable deliveries to a user or specific device within a Pushover group. Use when suspending notifications for a user (or device) in an active group.
  - body: { user: string, token: string, device?: string, group_key: string }
- `POST https://api.mcp.ai/api/pushover/group/enable/user` — Tool to re-enable deliveries to a previously disabled user (or specific device) within a Pushover group. Use after disabling a user's or device's notifications to restore delivery.
  - body: { user: string, token: string, device?: string, group_key: string }
- `POST https://api.mcp.ai/api/pushover/group/get` — Tool to retrieve details for a Delivery Group. Use when you need to fetch a group's name and member list.
  - body: { token: string, group_key: string }
- `POST https://api.mcp.ai/api/pushover/group/list` — Tool to list all Delivery Groups. Use when you need to retrieve your account's delivery groups after obtaining a valid API token.
  - body: { token: string }
- `POST https://api.mcp.ai/api/pushover/group/remove/user` — Tool to remove a user (or optionally a specific device) from a Pushover delivery group. Use when you need to revoke a user's membership so they stop receiving group notifications.
  - body: { user: string, token: string, device?: string, group_key: string }
- `POST https://api.mcp.ai/api/pushover/group/rename` — Tool to rename an existing Delivery Group. Use after confirming the group_key to update a group's name.
  - body: { name: string, token: string, group_key: string }
- `POST https://api.mcp.ai/api/pushover/license/assign` — Tool to assign a pre-paid license credit to a Pushover user by key or email. Use when you need to allocate a license and optionally restrict to a specific platform.
  - body: { os?: string, user?: string, email?: string, token: string }
- `POST https://api.mcp.ai/api/pushover/license/check/credits` — Tool to retrieve remaining license credits for a Pushover application. Use when monitoring your licensing quota before assigning new licenses.
  - body: { token: string }
- `POST https://api.mcp.ai/api/pushover/send/message` — Tool to send a push notification with optional title, URL, priority, sound, attachments, and filters.
  - body: { ttl?: integer, url?: string, html?: integer, tags?: string, user: string, retry?: integer, sound?: string, title?: string, token: string, device?: string, expire?: integer, message: string, callback?: string, priority?: integer, monospace?: integer, timestamp?: integer, url_title?: string, attachment?: object, attachment_type?: string, attachment_base64?: string }
- `POST https://api.mcp.ai/api/pushover/store/team/api/token` — Tool to securely store a Pushover for Teams API token. Use after obtaining a team API token to enable subsequent Teams actions.
  - body: { token: string }
- `POST https://api.mcp.ai/api/pushover/subscription/flow` — Tool to validate and return a Pushover subscription code. Use when Pushover does not support programmatic subscription creation and you need to confirm your code before redirecting users.
  - body: { subscription_code: string }
- `POST https://api.mcp.ai/api/pushover/teams/add/user` — Tool to add a user to a Pushover for Teams organization. Use when inviting a user with optional admin rights, instant login link, or custom delivery group.
  - body: { name?: string, admin?: string, email: string, group?: string, token: string, instant?: string, password?: string }
- `POST https://api.mcp.ai/api/pushover/teams/remove/user` — Tool to remove a user from a Pushover for Teams organization. Use when you need to revoke a user's access after confirming their email should be removed from the team.
  - body: { email: string, token: string }
- `POST https://api.mcp.ai/api/pushover/validate/user/or/group` — Tool to validate a Pushover user or group key for deliverability. Use before sending notifications to ensure the key (and optional device) is valid and has active devices.
  - body: { user: string, token: string, device?: string }

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

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