# ntfy (Push Notifications) MCP > ntfy (Push Notifications) lets your AI agent send and retrieve real-time alerts across different topics directly to any device. Send targeted messages with custom titles, priorities, tags, or schedule future notifications using just natural conversation. ## Overview - **Category:** productivity - **Price:** Free - **Tags:** push-notifications, pub-sub, real-time-alerts, http-api, cross-platform, messaging ## Description This MCP connects your chat agent to a robust pub/sub service, letting you manage critical system alerts and development updates in real time. You can publish specific push notifications to dedicated topics, automatically creating the channel if it doesn't exist. These messages support rich formatting like Markdown, plus you can customize everything—setting priority levels, adding tags, or including clickable links. If you need historical context, your agent can also pull cached logs from a topic so you know what happened minutes ago without checking a separate dashboard. Plus, you don't have to be online now; you can even schedule notifications for the future. Connecting this through Vinkius means your AI client handles all the complexity, bridging natural language requests with reliable push delivery across phones and desktops. ## Tools ### poll_messages Retrieves previous alert messages from a specified topic so you can see the history of events. ### publish_message Sends an immediate push notification to any designated ntfy topic, creating it if needed. ## Prompt Examples **Prompt:** ``` Send a high priority notification to the 'server-alerts' topic saying 'Database backup completed successfully' with a checkmark tag. ``` **Response:** ``` I've published the message to the 'server-alerts' topic with priority 4 and the 'white_check_mark' tag. The notification has been sent successfully. ``` **Prompt:** ``` Poll the last 5 minutes of messages from the 'dev-updates' topic. ``` **Response:** ``` I've retrieved the cached messages for 'dev-updates' from the last 5 minutes. I found 2 messages: 'Build #402 started' and 'Build #402 finished'. ``` **Prompt:** ``` Schedule a notification to the 'reminders' topic in 1 hour saying 'Time for the standup meeting!'. ``` **Response:** ``` I've scheduled your notification for the 'reminders' topic. It will be delivered in approximately 1 hour. ``` ## Capabilities ### Send immediate alerts You send a targeted notification to a specific topic using defined titles, priorities, tags, or rich content. ### Check historical message logs Your agent retrieves cached messages from a topic, allowing you to review past alerts and system events instantly. ### Schedule future reminders You set up a notification to send automatically at a specified time later on. ## Use Cases ### Monitoring Critical Deployments A DevOps engineer finishes a major deployment. Instead of waiting for an email, they ask their AI agent to use the `publish_message` tool, sending a high-priority notification to the 'production-alerts' topic. They get an instant phone alert saying, 'Deployment successful,' letting them know immediately without checking Slack or monitoring dashboards. ### Debugging CI/CD Pipelines A developer needs to track a long build process. They ask their agent to monitor the 'build-logs' topic and use `poll_messages` every few minutes. The agent reports finding specific log messages, like 'Build #402 failed at step 5,' letting them know exactly where the failure occurred. ### Team Reminders for Standups A manager needs to remind a team about a recurring meeting. They use their agent to schedule a notification using `publish_message` for 'meeting-reminders' in one hour, ensuring every relevant person gets the alert exactly when they need it. ### System Health Checks A system admin wants to know if the database backup completed successfully. They ask their agent to send a message via `publish_message` with a specific checkmark tag and high priority, guaranteeing that even if they are away from their desk, the critical status is delivered. ## Benefits - Immediate visibility: You don't have to keep tabs open. Send a notification, and it pops up right on your device when the event happens. - Contextual history: Need to know what triggered an alert? Use the `poll_messages` tool to check cached logs from a topic, giving you instant context without manual effort. - Structured communication: You control more than just the text. Publish notifications with custom titles, priority levels (like high or medium), and specific tags for easy filtering. - Advanced reliability: Send rich content that includes clickable URLs, custom icons, and files, making alerts actionable right away. - Time management: Forget to check on something? Use the scheduling features to set a reminder now that arrives automatically at a time you designate later. ## How It Works The bottom line is your AI agent handles connecting to the service, structuring the payload (priority, tags, content), and delivering the alert to your desired endpoint. 1. Subscribe this MCP and provide your ntfy instance URL (e.g., https://ntfy.sh) and any access token. 2. Your AI agent interprets a natural language request, determining if it needs to send an alert or check logs for a specific topic. 3. The system sends the structured command—whether publishing a message or polling cached data—and delivers the resulting real-time notification or log list. ## Frequently Asked Questions **How does ntfy (Push Notifications) MCP handle message history?** It uses the `poll_messages` tool to retrieve cached messages. This lets you look back at previous alerts on a specific topic without needing a dedicated logging dashboard. **Can I send notifications with custom tags using ntfy (Push Notifications) MCP?** Yes, when publishing a message, you can add structured metadata like tags. This lets your team filter alerts by type—for example, only showing 'Database' errors. **Is the ntfy (Push Notifications) MCP suitable for scheduled reminders?** Absolutely. You can schedule a notification to arrive at any future time using this MCP, perfect for automated meeting reminders or follow-up alerts. **Does ntfy (Push Notifications) MCP support different priorities?** Yes, you control the urgency of the message by setting a priority level. This helps your team visually distinguish between routine updates and critical failures instantly.