# OneSignal User Auth — MCP server on 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.

By: mcp.ai · official
Page: https://mcp.ai/onesignal_user_auth

## Connect (MCP protocol)
Remote MCP endpoint (HTTP, streamable): https://api.mcp.ai/p_onesignal_user_auth?ms=1787291400000
Add it as a custom/remote MCP connector, then authenticate when prompted.

## REST API (no MCP client required)
Every tool is also a REST endpoint, authed with a workspace API key.
Discover: GET https://api.mcp.ai/api/onesignal_user_auth/_endpoints   # public; lists every endpoint
Call:     POST https://api.mcp.ai/api/onesignal_user_auth/<endpoint>
  Authorization: Bearer sk_live_…   # create one at https://mcp.ai/settings/api-keys
  Content-Type: application/json
  Body: { …args }   →   { "ok": true, "tool": "<id>", "result": { … } }

## Developer docs
How to use (MCP or REST), markdown: https://mcp.ai/onesignal_user_auth/skill.md
Postman collection (v2.1): https://mcp.ai/onesignal_user_auth/postman.json

## Tools
- onesignal_user_auth_create_user(app_id: string, identity: object, properties?: object, subscriptions?: object[]) — 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.
- onesignal_user_auth_delete_alias(app_id: string, alias_id: string, alias_label?: string, alias_label_to_delete: string) — 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
- onesignal_user_auth_edit_device(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) — Tool to update an existing OneSignal device (player) record. Use when you have the player_id and need to modify device attributes.
- onesignal_user_auth_onesignal_view_segment(app_id: string, segment_id: string) — Tool to retrieve the subscriber count for a specific OneSignal segment. Use when you need to know how many subscribers are in a segment.
- onesignal_user_auth_update_subscription_by_token(token: string, app_id: string, token_type: string, subscription: object) — 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.
- onesignal_user_auth_view_app(app_id: string) — Tool to retrieve details for a specific OneSignal app. Use after authenticating to inspect app settings.
- onesignal_user_auth_view_broadcasts(limit?: integer, app_id: string, last_broadcast_id?: string) — 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.
- onesignal_user_auth_view_device(app_id?: string, player_id: string) — Tool to retrieve details for a specific device/player. Use when you have a player_id and optional app_id.
- onesignal_user_auth_view_outcomes(app_id: string, outcome_names?: string[], outcome_platforms?: string, outcome_time_range?: string, outcome_attribution?: string) — Tool to view all outcomes associated with a OneSignal app. Use to retrieve outcome metrics filtered by time range, platforms, and attribution type.
- onesignal_user_auth_view_segments(limit?: integer, app_id: string, offset?: integer) — Tool to list all segments for an app. Use after obtaining the app_id to retrieve a paginated list of segments.
- onesignal_user_auth_view_user(app_id: string, alias_id: string, alias_label: string) — Tool to retrieve user details by alias label and ID. Use when you need to fetch user data including tags, subscriptions, and identity information.
- onesignal_user_auth_view_user_unread_message_count(app_id: string, alias_id: string, alias_label: string) — 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.

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

## Links
Docs: https://mcp.ai/docs/mcps/onesignal_user_auth
Website: https://mcp.ai/mcps/onesignal_user_auth