31 tools from the OneSignal MCP Server, categorised by risk level.
View the OneSignal policy →get_segment Retrieve a single audience segment by ID. By default, includes full segment metadata and filters (`payload` object with `id`, `name`, `created_at`,... get_template Retrieve a single notification template by ID. get_user_identity Retrieve all identity aliases associated with a user. Identify the user by `alias_label` (typically "external_id") and `alias_id`. get_user_identity_by_subscription Retrieve the identity aliases for the user who owns a given subscription. list_messages List push notifications for a OneSignal app. Use `limit` (default 50, max ~250) and `offset` for pagination. Avoid large offsets — this endpoint ha... list_segments List audience segments for a OneSignal app. Maximum 300 segments per page. list_templates List notification templates for a OneSignal app. Maximum 50 per page. view_message Retrieve a single notification by ID. view_outcomes Retrieve outcome statistics for a OneSignal app (e.g. click counts, session duration). Note: data retention is approximately 30 days. view_user Retrieve a user and their properties by alias. Use `alias_label` "external_id" with the user's external ID, or another alias label you have configu... create_alias_by_subscription Create or update identity aliases for the user who owns a given subscription. The `onesignal_id` alias is read-only and must not be included. create_or_update_alias Create or update identity aliases for a user identified by alias. The `onesignal_id` alias is read-only and must not be included. create_segment Create a new audience segment with filter conditions. Maximum 200 filter entries. create_subscription Create a new subscription and attach it to a user. Set `type` to the channel ("Email", "SMS", "iOSPush", "AndroidPush", etc.) and `token` to the em... create_template Create a new notification template for a OneSignal app. create_user Create a new user in a OneSignal app. Provide an `identity` (e.g. {"external_id": "user-123"}) so the user can be referenced later by alias. Option... export_audience_activity_csv Export audience activity for a notification to CSV. WARNING: Only 1 concurrent export is allowed per account — if a 409 or 429 is returned, a previ... export_subscriptions_csv Export all subscriptions for a OneSignal app to CSV. WARNING: Only 1 concurrent export is allowed per account — if a 409 or 429 is returned, a prev... onesignal_config Return the current OneSignal MCP server configuration and connected app details. onesignal_health Check the health status of the OneSignal MCP server. onesignal_reference_overview Return an overview of the OneSignal REST API reference, including available endpoints and rate limits. send_message Send a push notification, email, or SMS via the OneSignal API. TIER 3 — HIGH IMPACT: confirmation is required before sending. Rate limited to 10 re... unsubscribe_email Unsubscribe an email address using the token from an email unsubscribe link. This endpoint uses token-based auth (no REST API key required). update_live_activity Update or end an active iOS Live Activity. update_segment Update an existing audience segment's name and/or filter conditions. `name` is always required even if not changing it (max 128 characters). When `... update_subscription Update an existing subscription (token, enabled status, or test type). update_subscription_by_token Update a subscription identified by its channel type and token. Provide `subscription_type` and `token` to identify the subscription, then pass the... update_template Update an existing notification template. The `name` field is required even if you are not changing it. update_user Update an existing user identified by alias. Use `properties` to set tags, language, or country. Use `deltas` to increment session counts or append... The OneSignal MCP server exposes 31 tools across 4 categories: Read, Write, Execute, Financial.
Use Intercept, the open-source MCP proxy. Write YAML rules for each tool — rate limits, argument validation, or deny rules — then run Intercept in front of the OneSignal server.
OneSignal tools are categorised as Read (10), Write (19), Execute (1), Financial (1). Each category has a recommended default policy.
Deterministic policy on every MCP tool call. Per-identity grants. Full audit log.