# MagicBell MCP for AI Agents AI Agent Connect > MagicBell lets you manage notifications and broadcasts via your AI agent. List, retrieve, and trigger multi-channel alerts directly from your current workspace. It handles the heavy lifting of sending messages to your audience and checking if they arrived, so you can stay focused on your work. You can send system alerts, marketing updates, or maintenance notices without leaving your editor. ## Overview - **Category:** productivity - **Price:** Free - **Endpoint:** https://edge.vinkius.com/vk_preview_Snj01cKu7iYRlh6xg6aAqWwrzp4RpKMffXWKKh6p/ai-agent-connect - **Tags:** notifications, multi-channel, push-alerts, broadcast-management, inbox-management, event-triggers ## Description MagicBell connects your notification system to your AI agent so you can handle mass communications in plain English. Instead of jumping into a complex dashboard to send a company-wide alert or check if a specific push notification reached its destination, you just tell your agent what to do. It handles the heavy lifting of filtering recipients, setting titles, and managing the multi-channel distribution across email, SMS, and push. You can quickly see what went out, who got it, and what the status of a specific campaign is. This is a big win for keeping everyone on the same page without the manual overhead of toggling between different tabs. You'll find this in the Vinkius catalog, where it sits alongside other tools that connect your internal data to your daily AI workflows. It ensures the right people get the right information at the right time, whether that's a critical system outage, a new feature launch, or a simple weekly update. It takes the friction out of broadcasting by letting you manage your entire communication pipeline through a single conversation. You can verify that your messages are landing correctly and even see the processing status in real time, ensuring that your team or your customers never miss a beat. ## Tools ### create_broadcast Send a new message to your audience with a custom title, body, and recipient filters. You can trigger these alerts instantly from your AI client. ### get_broadcast Fetch the details, title, and delivery status for a specific broadcast using its unique ID. This helps you verify if a message reached its destination. ### list_broadcasts View a full list of every broadcast your project has sent. This gives you a clear history of your communication logs. ## Prompt Examples **Prompt:** ``` List all recent broadcasts in my MagicBell project. ``` **Response:** ``` I've pulled the history for your MagicBell project. Here are the recent broadcasts: - **Welcome Campaign** (ID: 8a2...) - **System Alert** (ID: 4f1...) - **Weekly Digest** (ID: 9c2...) Which one would you like to see more details for? ``` **Prompt:** ``` Show me the details and status for broadcast ID 550e8400-e29b-41d4-a716-446655440000. ``` **Response:** ``` Checking that broadcast for you... - **Status:** Processed - **Title:** Maintenance Notice - **Reach:** 1,240 recipients - **Channels:** Email and Web Push Everything looks good; it was delivered successfully. ``` **Prompt:** ``` Create a new broadcast titled 'Flash Sale' with content 'Get 50% off today only!' for all recipients. ``` **Response:** ``` I've created the 'Flash Sale' broadcast for you. - **Title:** Flash Sale - **Content:** Get 50% off today only! - **Status:** Processing You can track this using the ID: **771b92...** ``` ## Capabilities ### Create new broadcasts Trigger a message to your audience with a custom title and body. ### List all project broadcasts See a history of every alert your project has sent. ### Fetch specific broadcast details Get the status and content of a single message using its ID. ### Manage multi-channel overrides Control how messages appear on different platforms like SMS or email. ### Filter recipients Target specific user segments for your alerts. ## Use Cases ### Emergency Outage Alert An engineer sees a site down and asks the agent to use `create_broadcast` to send a 'System Maintenance' alert to all users. ### Flash Sale Launch A marketing lead tells the agent to trigger a '50% Off' push notification for a specific user segment. ### Post-Migration Check A support lead asks the agent to check the status of a specific broadcast to see if it reached a high-priority client. ### New Feature Welcome A product manager uses the agent to send a 'Welcome' email to a new batch of signed-up users. ## Benefits - Send alerts instantly: Push messages to your audience in seconds rather than manually configuring a campaign. - Verify delivery status: Confirm if a notification actually reached the intended recipients. - Audit communication history: Keep a clear record of every alert sent through your system. - Reduce dashboard fatigue: Stop switching tabs between your app and your notification tool to manage simple updates. - Test payloads easily: Developers can verify how different notification categories look before they go live. ## How It Works The bottom line is you get a voice-controlled way to manage your entire notification pipeline. 1. Subscribe to the Connector and grab your MagicBell Project JWT. 2. Plug the JWT into your AI client's configuration. 3. Ask your agent to send a broadcast or check a status. ## Frequently Asked Questions **What is the MagicBell MCP?** It's a way to connect your MagicBell notification system to your AI agent. You can use it to send messages and check statuses without leaving your chat. **How do I send a push notification using MagicBell?** You just ask your AI agent to create a broadcast. It will handle the content, title, and distribution for you. **Can I check if a broadcast was successful?** Yes, you can ask the agent to fetch the status of a specific broadcast ID. It will tell you how many people received it. **Does MagicBell support SMS and Email?** Yes, the Connector handles multi-channel overrides so you can send messages across email, SMS, and push. **Who can use the MagicBell MCP?** It's great for product managers, support teams, and developers who need to manage large-scale notifications quickly. **How do I get my project JWT?** You can find your project JWT in your MagicBell dashboard settings. You'll need to provide this to the Connector to connect your account. **Can I send a notification to specific users or groups?** Yes! When using the `create_broadcast` tool, you can provide an array of user IDs or emails in the `recipients` field to target specific individuals or segments. **How do I check if a broadcast has been successfully processed?** You can use the `get_broadcast` tool with the unique broadcast ID. It will return the current processing status and metadata for that specific notification event. **Is it possible to customize the message content for different channels like Email or SMS?** Absolutely. The `create_broadcast` tool includes an `overrides` parameter where you can specify different content or templates for specific channels (email, sms, push).