# OneSignal MCP for AI Agents AI Agent Connect > OneSignal MCP lets you manage push notifications, emails, and SMS campaigns through your AI client. You can send alerts, manage user segments, and check delivery stats without leaving your chat window. It handles the heavy lifting of omnichannel engagement, giving you a direct line to your users. ## Overview - **Category:** industry-titans - **Price:** Free - **Endpoint:** https://edge.vinkius.com/vk_preview_n4u6ZwoMBcvPcOonEHoLz0ChyfNdoS0xpGNyovxL/ai-agent-connect - **Tags:** onesignal, push-notifications, omnichannel-marketing, sms-api, email-automation, user-segmentation, engagement-analytics, growth-ops, mcp ## Description OneSignal MCP lets you handle your entire customer engagement strategy directly through your AI client. Instead of jumping between dashboards to send a quick alert or check who's seeing your content, you can just tell your agent what to do. You can send out push notifications, emails, and SMS messages to specific groups of people while keeping your CRM data clean by updating player profiles and custom tags. It takes the friction out of growth operations because you can monitor your campaign performance and see exactly how many people clicked or opened a message in real time. Since Vinkius hosts this in their catalog, you get a reliable way to connect these powers to your existing AI workflow without needing to build a custom bridge. It turns your AI into a growth operations manager that knows your audience and can react to events instantly. ## Tools ### send_push_notification Send a proactive alert to your chosen audience. Use this to reach users with timely, relevant content. ### cancel_scheduled_alert Stop a notification that's already queued for later. This is useful if a campaign needs to be pulled immediately. ### remove_player Delete a specific device record from your list. This helps keep your active user list clean and accurate. ### get_api_status Check if your connection to the service is active. Use this to ensure your pipeline is healthy. ### get_app_details Get the configuration info for a specific app. This provides the context needed for your notification settings. ### get_notification_stats Check the delivery metrics for a specific message. Use this to see open rates and click counts. ### get_player_details Pull the profile and metadata for a single user. Use this to check specific tags or device info. ### list_onesignal_apps See all your different applications in one list. This helps you manage multiple projects from one spot. ### list_recent_notifications View a history of your past alerts. Use this to quickly reference what was sent recently. ### list_app_outcomes Get the results and engagement data for your campaigns. It shows how well your messages performed. ### list_app_segments View all your different target groups. This allows you to see who you can reach with your next message. ### list_app_players See all the devices currently subscribed to your app. Use this to check your total reachable audience. ## Prompt Examples **Prompt:** ``` Send a push notification to all users in the 'Beta Testers' segment saying the new update is live. ``` **Response:** ``` Push notification sent successfully to the "Beta Testers" segment. 4,287 devices targeted across iOS (2,103) and Android (2,184). The message "Exclusive early access to our summer collection is live" was delivered with a deep link to your promotion page. Estimated delivery time: under 30 seconds. ``` **Prompt:** ``` How many people opened the 'Summer Sale' notification we sent yesterday? ``` **Response:** ``` Notification "Summer Sale" was sent to 12,450 subscribers. **Delivery Stats:** - **Delivered:** 11,892 (95.5%) - **Opened:** 3,214 (27% CTR) - **Clicked:** 1,847 (14.8% click rate) iOS performed better with 31% CTR versus Android at 24%. ``` **Prompt:** ``` Show me the details for the user with ID 12345 and tell me what tags they have. ``` **Response:** ``` I've retrieved the profile for user 12345: - **Device:** iPhone 14 Pro - **OS:** iOS 16.5 - **Tags:** `VIP_User`, `Early_Adopter`, `Region_North_America` - **Last Active:** 2 hours ago ``` ## Capabilities ### Send push notifications Dispatch proactive alerts to specific user groups instantly. ### Manage audience segments View and filter your target groups using natural language. ### Update player profiles Modify user tags and metadata to keep your CRM accurate. ### Monitor delivery stats Check how many messages were sent, opened, or clicked. ### Track campaign outcomes See the results and engagement data for your specific marketing broadcasts. ### List subscribed devices See which users are currently opted into your alerts. ## Use Cases ### Alerting VIP users about a flash sale A marketer asks the agent to find the VIP segment using list_app_segments and then uses send_push_notification to blast a 20% off coupon. ### Checking the performance of a recent blast A product manager asks for the stats on the last update alert and uses list_recent_notifications followed by get_notification_stats. ### Removing a user who opted out An ops lead asks the agent to delete a specific device record using remove_player to keep the mailing list clean. ### Auditing campaign outcomes A growth lead wants to see the click rates for the last three campaigns and uses list_app_outcomes to gather the data. ## Benefits - Send alerts faster by using send_push_notification to reach users without opening a browser. - Keep your data clean by using get_player_details and updating tags via your agent. - Monitor success rates instantly with get_notification_stats to see real-time engagement. - Target the right people by using list_app_segments to filter your audience by specific criteria. - Manage your app footprint by using list_onesignal_apps to see all your active projects at once. - Handle errors quickly by using cancel_scheduled_alert to stop messages before they go out. ## How It Works The bottom line is you get a direct command line for your entire omnichannel notification system. 1. Connect your OneSignal App ID and REST API Key in your AI client. 2. Describe the notification or audience you want to target in plain English. 3. Receive a confirmation and real-time stats on the delivery. ## Frequently Asked Questions **Can I use the OneSignal MCP to send SMS?** Yes, this Connector handles omnichannel delivery including push notifications, SMS, and emails. **Does the OneSignal MCP support audience segmentation?** Yes, you can use it to list and target specific audience segments using natural language. **Can I see my notification history?** Yes, you can view a history of your past alerts to see what was sent and when. **How do I update user tags with this?** You can retrieve specific player details and update their tags or metadata directly through your agent. **Can I stop a notification that's already scheduled?** Yes, you can use the tools to cancel alerts that are already queued for later. **Is this good for tracking campaign results?** Yes, it pulls delivery metrics and campaign outcomes so you can see exactly how your audience is responding. **Can I check if my app is connected correctly?** Yes, you can check the API status at any time to ensure your connection is active. **How do I manage specific user profiles?** You can pull individual user profiles to see their device info, tags, and other metadata. **Can my AI automatically find the Player ID for a specific user to send a test push?** Yes! Use the `list_users` tool. Your agent will respond with complete metadata for registered devices, including unique Player IDs and tags, allowing you to trigger targeted pushes instantly. **How do I find my OneSignal App ID and REST API Key?** Log in to OneSignal, select your app, navigate to **Settings** > **Keys & IDs**, and you will find your unique App ID and secret REST API key there. **Can I use the AI to cancel a scheduled notification?** Absolutely. Use the `cancel_notification` tool with the Notification ID. The agent will instruct OneSignal to stop the broadcast immediately, provided it hasn't been fully delivered yet.