# Ntfy — MCP server on 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.

By: mcp.ai · official
Page: https://mcp.ai/ntfy

## Connect (MCP protocol)
Remote MCP endpoint (HTTP, streamable): https://api.mcp.ai/p_ntfy?ms=1787293560000
Add it as a custom/remote MCP connector, then authenticate when prompted.

## REST API (no MCP client required)
Every tool is also a REST endpoint, authed with a workspace API key.
Discover: GET https://api.mcp.ai/api/ntfy/_endpoints   # public; lists every endpoint
Call:     POST https://api.mcp.ai/api/ntfy/<endpoint>
  Authorization: Bearer sk_live_…   # create one at https://mcp.ai/settings/api-keys
  Content-Type: application/json
  Body: { …args }   →   { "ok": true, "tool": "<id>", "result": { … } }

## Developer docs
How to use (MCP or REST), markdown: https://mcp.ai/ntfy/skill.md
Postman collection (v2.1): https://mcp.ai/ntfy/postman.json

## Tools
- ntfy_create_account(password: string, username: string) — 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
- ntfy_create_webpush_subscription(auth: string, p256dh: string, topics?: string[], endpoint: string) — 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.
- ntfy_delete_webpush_subscription(endpoint: string) — 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.
- ntfy_fetch_scheduled_messages(auth?: string, topic: string) — 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
- 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.
- 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.
- 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
- ntfy_head_file(message_id: string) — 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.
- 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.
- ntfy_publish_message(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) — 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.
- ntfy_publish_via_get(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) — 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
- ntfy_subscribe_raw_stream(id?: string, poll?: boolean, tags?: string, since?: string, title?: string, topic: string, message?: string, priority?: string, scheduled?: boolean) — 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

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

## Links
Docs: https://mcp.ai/docs/mcps/ntfy
Website: https://mcp.ai/mcps/ntfy