• STATUS
  • LOGS
  • ACTION
  • HUMAN

How to troubleshoot notification delivery with your AI

Connect OneSignal to your AI client to dig into delivery failures. Once connected, your agent can pull specific logs to find the root cause of missed messages.

Ask AI about this page

Short answer

Why didn't my user receive this notification?

Your AI checks the player's status and the specific notification logs to see if the issue is a blocked device, an expired token, or a delivery failure. You'll get a clear breakdown of the delivery state for any specific message or user.

Where every issue lands.

Troubleshooting outcomes

The AI categorizes the results of its investigation into actionable buckets.

STATUS

Delivery state identified

The AI uses player data to tell you if the device is active or if the subscription has lapsed.

LOGS

Message history found

Your agent pulls the specific history for a notification to see if it was sent, delivered, or failed.

ACTION

Next steps ready

The AI suggests whether you need to refresh a token or if the issue is on the device side.

HUMAN

Manual fix required

If the logs show a hard failure, the AI flags that you need to contact the user or fix the app code.

The workflow

What your AI does when a delivery issue is reported.

The AI moves from broad user data to specific message logs to isolate the failure point.

  1. Check user status

    The AI looks up the specific user to see if their device is currently registered and active.

    get_player

  2. Pull message history

    Your agent retrieves the list of recent messages sent to that specific user.

    list_notifications

  3. Inspect specific failure

    The AI examines the exact status of a single notification to see the error code or delivery timestamp.

    get_notification

  4. Summarize the cause

    The AI combines the player state and the notification status to explain why the message failed.

    get_playerget_notification

Try it

Copy these to start.

Use these prompts to begin your investigation.

Starting points

Swap out the bracketed info for your actual OneSignal IDs.

OneSignal Connector

You're all set. Choose your MCP client and follow the setup instructions.

Connector linkhttps://edge.vinkius.com/vk_preview_BURKE5PMzSnmSC2KP6Ci4WVL1WqWtaYVOiP1cMAO/mcp

Claude Desktop

Follow the steps below to connect in seconds.

  1. 1In Claude Desktop, open Settings → Connectors.
  2. 2Click “Add custom connector” and paste the connector link above as the remote MCP server URL.
  3. 3Click Add and start a new chat — OneSignal capabilities are ready to use.
Configuration · claude_desktop_config.jsonCopy
{
  "mcpServers": {
    "onesignal-mcp": {
      "url": "https://edge.vinkius.com/vk_preview_BURKE5PMzSnmSC2KP6Ci4WVL1WqWtaYVOiP1cMAO/mcp"
    }
  }
}
Copy into chat04

  • Check the status for player ID [ID] to see if they are active.

  • List the recent notifications for player [ID] and tell me which ones failed.

  • Look up notification [ID] and explain why the status is 'failed'.

  • Why did the notification sent to player [ID] not reach their device?

  • Claude
  • ChatGPT
  • Cursor
  • VS Code
  • Windsurf
  • Claude Code
  • JetBrains
  • Cline

Start here

Connect OneSignal once, then ask.

Just provide your OneSignal credentials. The connection is encrypted, and you can start troubleshooting immediately in your preferred client.

Connect OneSignal to your AI

FAQ

How this task behaves

  • 01

    Can the AI send a new notification to a user?

    No. This MCP is for inspecting player data and notification statuses only.

  • 02

    Can the AI delete a user from OneSignal?

    No. The AI can only read data; it cannot modify or delete your OneSignal records.

  • 03

    Does the AI need my OneSignal API Key?

    Yes, you provide the credentials through Vinkius to allow the AI to access your data.

  • 04

    Can I troubleshoot push notifications for iOS and Android?

    Yes, as long as the player data and notification logs are present in your OneSignal account.

  • 05

    Can the AI fix a broken push token?

    No. The AI can identify that a token is invalid, but you must handle the token update in your app code.

  • More questions about OneSignal? The Connector page answers them. See everything the OneSignal Connector can do

Connect OneSignal to Claude, Cursor, ChatGPT & more