# OneSignal MCP for AI Agents AI Agent Connect

> OneSignal MCP lets you manage your push notification lifecycle directly through your AI agent. Send messages, target specific audience segments, and pull delivery analytics without leaving your chat window. It bridges the gap between your engagement strategy and your daily workflow.

## Overview
- **Category:** growth-engine
- **Price:** Free
- **Endpoint:** https://edge.vinkius.com/vk_preview_BURKE5PMzSnmSC2KP6Ci4WVL1WqWtaYVOiP1cMAO/ai-agent-connect
- **Tags:** push-notifications, customer-engagement, in-app-messaging, audience-segmentation, message-automation

## Description

Connecting your OneSignal account to an AI agent changes how you handle mobile engagement. Instead of jumping between tabs to find the right audience or double-checking if a campaign actually went out, you can just ask your agent to do it. You can draft and send push notifications to specific groups, schedule messages for later, or quickly pull stats on how many people actually saw your update. It makes the whole process feel like a conversation rather than a series of clicks in a dashboard. If you're looking for a way to put your growth stack into a single interface, this is how you do it on Vinkius. You get to move faster because the agent handles the heavy lifting of navigating the OneSignal interface for you. Whether you're trying to hit a specific segment of users or just need to see the latest device registrations, it's all accessible in one place.

## Tools

### delete_player
Remove a specific registered device from your list. This helps keep your active user data clean.

### get_app
Pull specific details for a OneSignal app using your auth key. This gives you a quick look at your app configuration.

### get_notification
Check the current status of a specific notification. Use this to verify if a campaign is live or failed.

### get_outcomes
Fetch the engagement data and outcomes for a specific app. This lets you see how users are interacting with your content.

### get_player
Retrieve specific metadata for a registered player. This is useful for troubleshooting individual user issues.

### list_players
Get a list of all registered devices currently in your system. This allows you to see your active reach across platforms.

### create_notification
Send a new push notification to your target audience. Use this to trigger immediate engagement from your users.

### cancel_notification
Stop a scheduled push notification before it goes out. This helps you fix typos or timing issues instantly.

### list_apps
See all your connected OneSignal applications at once. Use this to get a bird's-eye view of your notification infrastructure.

### list_notifications
View a history of notifications sent for your app. This helps you audit past campaigns and their delivery status.

## Prompt Examples

**Prompt:** 
```
Send a push to everyone saying we have a new update.
```

**Response:** 
```
### Notification Sent

I've sent that update to your active users. Here are the details:

*   **Status:** Success
*   **Notification ID:** `OS-992834-XJ`
*   **Target Segment:** All Subscribed Users

You can ask me to check the delivery stats in a few minutes if you'd like.
```

**Prompt:** 
```
Did people see the notification from last night?
```

**Response:** 
```
### Delivery Report

I've pulled the outcome data for last night's campaign:

| Metric | Value |
| :--- | :--- |
| **Total Delivered** | 12,450 |
| **Success Rate** | 98.2% |
| **Failed** | 130 |

Most users engaged within the first 10 minutes.
```

**Prompt:** 
```
Show me the last 3 devices that joined.
```

**Response:** 
```
### Recent Registrations

Here are the last 3 devices that registered with your app:

1. **iPhone 15** (iOS) - *Active 2 mins ago*
2. **Samsung Galaxy S23** (Android) - *Active 15 mins ago*
3. **Pixel 8** (Android) - *Active 1 hour ago*
```

## Capabilities

### Send push notifications
Trigger messages to your mobile or web users instantly.

### Schedule future messages
Set up push notifications to go out at a specific time.

### Pull delivery analytics
Get real-time stats on how many people saw your messages.

### Manage device lists
View and remove registered players from your app.

### View app configurations
Check your OneSignal app settings and details on demand.

### Cancel pending messages
Stop a scheduled notification before it reaches users.

## Use Cases

### Flash Sale Alert
A marketing lead asks the agent to send a 50% off notification to the 'Active Users' segment using create_notification.

### Delivery Audit
A support lead asks for the success rate of last night's notification to see why some users didn't get it using get_notification.

### Dev Testing
A developer asks the agent to list the last 3 devices to verify that their new app build is registering correctly using list_players.

### Campaign Cleanup
A manager asks the agent to cancel a scheduled notification because the marketing copy had a typo using cancel_notification.

## Benefits

- Faster campaign deployment: Use create_notification to send alerts in seconds instead of navigating complex menus.
- Easier audience targeting: Use list_players and list_notifications to identify who saw what without manual filtering.
- Instant status checks: Use get_notification to see if a message is live or failed immediately.
- Simplified device management: Use delete_player to clean up your registry during testing or troubleshooting.
- Quick data retrieval: Use get_outcomes to grab engagement metrics for your reports without exporting CSVs.
- Better app oversight: Use list_apps and get_app to keep track of all your mobile configurations in one place.

## How It Works

The bottom line is you get a voice-controlled dashboard for your entire push notification strategy.

1. Subscribe to the OneSignal MCP and provide your REST API Key and App ID.
2. Add your User Auth Key if you need to perform account-level actions.
3. Ask your agent to send a message, pull a report, or list your apps.

## Frequently Asked Questions

**Can I use OneSignal MCP to send messages to specific groups?**
Yes. You can ask your agent to target specific audience segments or individual player IDs to ensure the right message reaches the right people.

**How does OneSignal MCP help with marketing automation?**
It lets you trigger, schedule, and manage push notifications through a conversation. You can handle entire campaigns without manually navigating the dashboard.

**Can I check if a user received a push notification?**
Yes. You can query the status of specific notifications to see delivery success rates and engagement metrics instantly.

**Does OneSignal MCP support both mobile and web?**
It supports both. You can manage notifications across your entire notification infrastructure, including mobile apps and web platforms.

**How do I manage my apps using this Connector?**
You can list all your connected applications and pull specific configuration details for any individual app just by asking your agent.

**Can I target specific users instead of sending to everyone?**
Yes! Use the `create_notification` tool and provide a list of `include_player_ids`. This ensures the notification is only delivered to the specific devices you've identified.

**How can I check if a scheduled notification was actually sent?**
You can use the `get_notification` tool with the Notification ID. It will return real-time delivery metrics, including the number of successful deliveries and current status.

**Is it possible to manage multiple OneSignal apps?**
Yes. While the core operations use the primary App ID provided in credentials, you can use `list_apps` (requires User Auth Key) to see all your applications and their respective IDs.