# Ntfy — how to use (mcp.ai)

Connect your Ntfy account and use 12 tools for notifications straight from your AI agent. Connect with your own API key. Send push notifications to your phone or desktop via PUT/POST.

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

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

### Endpoints
- `POST https://api.mcp.ai/api/ntfy/create/account` — Tool to register a new user account on ntfy. Use when you need to create a new user account on the ntfy.sh hosted service. Note: This endpoint is not available on self-hosted instances unless signup i
  - body: { password: string, username: string }
- `POST https://api.mcp.ai/api/ntfy/create/webpush/subscription` — Tool to register a web push subscription for browser notifications. Use when you need to enable push notifications from ntfy topics through a browser's native push notification system.
  - body: { auth: string, p256dh: string, topics?: string[], endpoint: string }
- `POST https://api.mcp.ai/api/ntfy/delete/webpush/subscription` — Tool to unregister a web push subscription from the ntfy server. Use when you need to remove browser push notifications for a previously registered endpoint.
  - body: { endpoint: string }
- `POST https://api.mcp.ai/api/ntfy/fetch/scheduled/messages` — Tool to fetch messages scheduled for later delivery from a topic. Use when you need to retrieve messages that are set to be delivered at a future date. The poll=1 and scheduled=1 parameters are automa
  - body: { auth?: string, topic: string }
- `POST https://api.mcp.ai/api/ntfy/get/account` — Tool to retrieve account data for authenticated user or anonymous user. Use when you need to get account information, limits, statistics, or tier details.
- `POST https://api.mcp.ai/api/ntfy/get/stats` — Tool to retrieve server statistics including message counts and publishing rates. Use when you need to monitor ntfy server activity and get metrics about message volume.
- `POST https://api.mcp.ai/api/ntfy/get/tiers` — Tool to list all available ntfy service tiers with their limits and features. Use when you need to retrieve subscription tier information including pricing and usage limits. Requires that payments are
- `POST https://api.mcp.ai/api/ntfy/head/file` — Tool to get file attachment metadata from a message without downloading the file content. Use when you need to check file size, content type, or verify file existence in the ntfy attachment cache.
  - body: { message_id: string }
- `POST https://api.mcp.ai/api/ntfy/health/check` — Tool to check the health status of the ntfy service. Use when you need to verify if the ntfy service is operational and responding correctly.
- `POST https://api.mcp.ai/api/ntfy/publish/message` — Tool to publish a message to a ntfy topic. Use when you need to send notifications or alerts to a topic. Topics are created dynamically if they don't exist.
  - body: { icon?: string, tags?: string, click?: string, delay?: string, email?: string, title?: string, topic: string, attach?: string, actions?: string, message: string, filename?: string, markdown?: boolean, priority?: integer }
- `POST https://api.mcp.ai/api/ntfy/publish/via/get` — Tool to publish messages to ntfy via GET request with URL parameters. Use when PUT/POST methods are unavailable or for simple webhook integration. Supports all message parameters as query strings. Wit
  - body: { auth?: string, call?: string, icon?: string, tags?: string, cache?: string, click?: string, delay?: string, email?: string, title?: string, topic: string, attach?: string, actions?: string, message?: string, filename?: string, firebase?: string, markdown?: boolean, priority?: integer, template?: string }
- `POST https://api.mcp.ai/api/ntfy/subscribe/raw/stream` — Tool to subscribe to a topic and receive message bodies as raw text stream. Use when you need to retrieve messages without metadata like priority, tags, or titles. Each line in the response contains o
  - body: { id?: string, poll?: boolean, tags?: string, since?: string, title?: string, topic: string, message?: string, priority?: string, scheduled?: boolean }

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

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