# OneSignal User Auth — how to use (mcp.ai)

Connect your OneSignal User Auth account and use 12 tools for notifications straight from your AI agent. Connect with your own API key. OneSignal is a customer engagement platform offering push notifications, email, SMS, and in-app messaging services.

## Option A — via MCP (recommended)
Remote MCP endpoint (HTTP, streamable): `https://api.mcp.ai/p_onesignal_user_auth?ms=1787293500000`
Add it as a custom/remote MCP connector in your client (Claude, Cursor, VS Code…), then authenticate when prompted. Once connected, ask the agent to use the server's tools (e.g. `onesignal_user_auth_create_user`).

## Option B — via direct REST API
Base URL: `https://api.mcp.ai/api/onesignal_user_auth`
Auth: `Authorization: Bearer sk_live_…` — create a workspace API key at https://mcp.ai/settings/api-keys
Discover endpoints: `GET https://api.mcp.ai/api/onesignal_user_auth/_endpoints`

### Endpoints
- `POST https://api.mcp.ai/api/onesignal_user_auth/create/user` — Tool to create a new user or modify the subscriptions associated with an existing user. Use when you need to register a user with OneSignal or update their subscriptions.
  - body: { app_id: string, identity: object, properties?: object, subscriptions?: object[] }
- `POST https://api.mcp.ai/api/onesignal_user_auth/delete/alias` — Tool to remove an alias from a OneSignal user. Use when you need to delete a specific alias identifier from a user while preserving other aliases. The user is identified by one alias (alias_label/alia
  - body: { app_id: string, alias_id: string, alias_label?: string, alias_label_to_delete: string }
- `POST https://api.mcp.ai/api/onesignal_user_auth/edit/device` — Tool to update an existing OneSignal device (player) record. Use when you have the player_id and need to modify device attributes.
  - body: { lat?: number, sdk?: string, long?: number, tags?: object, ad_id?: string, app_id?: string, country?: string, language?: string, playtime?: integer, timezone?: integer, device_os?: string, player_id: string, created_at?: integer, identifier?: string, badge_count?: integer, last_active?: integer, amount_spent?: number, device_model?: string, game_version?: string, session_count?: integer, notification_types?: integer }
- `POST https://api.mcp.ai/api/onesignal_user_auth/onesignal/view/segment` — Tool to retrieve the subscriber count for a specific OneSignal segment. Use when you need to know how many subscribers are in a segment.
  - body: { app_id: string, segment_id: string }
- `POST https://api.mcp.ai/api/onesignal_user_auth/update/subscription/by/token` — Tool to update properties on an existing subscription using its token. Use when you need to enable or disable subscription status when managing outside of the OneSignal SDK.
  - body: { token: string, app_id: string, token_type: string, subscription: object }
- `POST https://api.mcp.ai/api/onesignal_user_auth/view/app` — Tool to retrieve details for a specific OneSignal app. Use after authenticating to inspect app settings.
  - body: { app_id: string }
- `POST https://api.mcp.ai/api/onesignal_user_auth/view/broadcasts` — Tool to view inbox broadcasts for a OneSignal app. Returns broadcasts in descending order of creation. Use when retrieving in-app messages or inbox content for an app.
  - body: { limit?: integer, app_id: string, last_broadcast_id?: string }
- `POST https://api.mcp.ai/api/onesignal_user_auth/view/device` — Tool to retrieve details for a specific device/player. Use when you have a player_id and optional app_id.
  - body: { app_id?: string, player_id: string }
- `POST https://api.mcp.ai/api/onesignal_user_auth/view/outcomes` — Tool to view all outcomes associated with a OneSignal app. Use to retrieve outcome metrics filtered by time range, platforms, and attribution type.
  - body: { app_id: string, outcome_names?: string[], outcome_platforms?: string, outcome_time_range?: string, outcome_attribution?: string }
- `POST https://api.mcp.ai/api/onesignal_user_auth/view/segments` — Tool to list all segments for an app. Use after obtaining the app_id to retrieve a paginated list of segments.
  - body: { limit?: integer, app_id: string, offset?: integer }
- `POST https://api.mcp.ai/api/onesignal_user_auth/view/user` — Tool to retrieve user details by alias label and ID. Use when you need to fetch user data including tags, subscriptions, and identity information.
  - body: { app_id: string, alias_id: string, alias_label: string }
- `POST https://api.mcp.ai/api/onesignal_user_auth/view/user/unread/message/count` — Tool to retrieve the unread message count for a specific user. Use when you need to check how many unread inbox messages a user has.
  - body: { app_id: string, alias_id: string, alias_label: string }

## Example prompts
- "What can I do in OneSignal User Auth?"
- "Show me a summary of my OneSignal User Auth account"

## More
- Page: https://mcp.ai/onesignal_user_auth
- Agent spec (llms.txt): https://mcp.ai/onesignal_user_auth/llms.txt
- Postman collection: https://mcp.ai/onesignal_user_auth/postman.json