# ntfy (Push Notifications) MCP for AI Agents AI Agent Connect > ntfy (Push Notifications) MCP lets your AI agent send real-time push notifications to your phone, desktop, or browser. It bridges the gap between your agent's actions and your personal devices, allowing for instant alerts on deployment status, long-running tasks, or system errors without you having to keep a terminal window open. It is the fastest way to get mobile pings from your automated workflows. ## Overview - **Category:** productivity - **Price:** Free - **Endpoint:** https://edge.vinkius.com/vk_preview_ktVeENNHwfdlOfmq0cVOwgX6JIkWtDxTzBj8FeX6/ai-agent-connect - **Tags:** push-notifications, pub-sub, real-time-alerts, http-api, cross-platform, messaging ## Description This Connector connects your notification service to your AI agent so you can manage real-time alerts through a normal conversation. This service is a simple way to send notifications to your phone or desktop using an HTTP-based pub-sub system. Instead of keeping a terminal window open to watch a long script run, you can have your agent ping your device the second a task finishes. It turns your agent into a proactive teammate that keeps you in the loop while you do other things. You don't have to build a custom backend or mess with complex webhooks. You just tell your agent what to do, and it handles the communication. It's one of the easiest ways to keep your workflow moving without being tethered to your screen. Since Vinkius manages the connection for you, you can get your agents talking to your devices in minutes. Whether you need a simple message or a rich notification with a clickable link, this tool handles the handoff. It works perfectly for developers who need to monitor deployments, DevOps engineers watching infrastructure health, or anyone who wants to bridge their AI workflows with mobile push notifications. You can use it for everything from simple reminders to complex system monitoring pings, making it a versatile bridge for your automated tasks. This makes it a reliable way to ensure you never miss a critical update while working on complex, multi-step projects. ## Tools ### publish_message The publish_message tool sends a push notification to a specific topic with custom titles, priorities, and tags. This allows for instant updates on system events. ### poll_messages The poll_messages tool fetches cached messages from a topic so you can see what happened while you were away. This is useful for catching up on missed logs. ## Prompt Examples **Prompt:** ``` Send a high priority notification to the 'system-alerts' topic saying 'Database backup completed successfully' with a checkmark tag. ``` **Response:** ``` I've sent that high-priority alert to your 'system-alerts' topic. You should see a notification on your device now with the checkmark tag. ``` **Prompt:** ``` Poll the last 5 minutes of messages from the 'dev-updates' topic. ``` **Response:** ``` I've checked the 'dev-updates' topic for the last 5 minutes. Here's what happened: * **Build #402 started** * **Build #402 finished** ``` **Prompt:** ``` Schedule a notification to the 'reminders' topic in 1 hour saying 'Time for the standup meeting!'. ``` **Response:** ``` Done. I've scheduled that reminder for the 'reminders' topic. You'll get a notification in about an hour. ``` ## Capabilities ### Send instant push notifications This Connector sends instant push notifications to your phone or desktop. ### Fetch previous alerts This Connector fetches cached messages from a specific topic. ### Attach clickable links This Connector attaches clickable links and files to your alerts. ### Schedule future alerts This Connector schedules notifications for a specific time in the future. ### Format messages with Markdown This Connector formats messages with Markdown for better readability. ## Use Cases ### Deployment Monitoring A dev asks the agent to start a production deploy. The agent uses publish_message to send a 'Deploy Started' ping to the dev's phone. ### Long-Running Scripts A data scientist runs a 2-hour training job. The agent pings a 'Job Complete' notification with a link to the results. ### System Health A DevOps pro sets up a watch. If a system goes down, the agent sends a high-priority alert to a dedicated notification topic. ### Task Reminders A project manager asks the agent to remind them about a meeting in an hour. The agent schedules a notification via the notification topic. ## Benefits - Get instant pings on your phone for long-running tasks by using publish_message to notify you the moment a script finishes. - Catch up on missed history by using poll_messages to see what happened while you were away from your desk. - Include clickable URLs and custom icons in your alerts to jump straight to the results or logs. - Organize your notifications by using tags and priorities to separate critical errors from routine status updates. - Schedule future alerts using the delay parameter so your agent can nudge you at a specific time without manual input. ## How It Works The bottom line is your agent can now give you a heads-up on its progress without you having to ask for updates. 1. Provide your notification service URL and an optional access token in the setup. 2. Tell your agent which topics to use for specific events like deployments or errors. 3. Receive real-time pings on your phone or desktop as the agent completes tasks. ## Frequently Asked Questions **Can I get notifications on my phone with ntfy MCP?** Yes, it sends pings to any device that has the app or browser notifications enabled. **Does ntfy MCP support custom icons?** Yes, the agent can include custom icons and clickable URLs in the push notifications. **How do I see old notifications?** You can use the tool to pull cached messages from a specific topic to see recent history. **Is ntfy MCP good for DevOps?** It's a great way to get instant alerts on deployment status or system errors without manual checking. **Can the agent schedule alerts?** Yes, you can tell the agent to send a notification at a specific time in the future. **Do I need a complex setup for ntfy MCP?** No, you just need your service URL and an optional token to get started. **Can I send emojis in my notifications?** Yes! Use the `tags` parameter in the `publish_message` tool. You can provide a comma-separated list of emojis or tags like 'warning,skull' to display them in the notification. **How do I check for messages that were sent while I was away?** You can use the `poll_messages` tool. By specifying the `topic` and optionally the `since` parameter, you can retrieve the history of cached messages from that topic. **Does this support self-hosted ntfy instances?** Absolutely. During setup, you can provide your custom `NTFY_URL`. If your instance requires authentication, you can also provide your `NTFY_TOKEN`.