How to integrate Onesignal user auth MCP with Atomic Agent

Connect Atomic Agent to Onesignal user auth MCP. Update device tags for a specific user, list all segments in your app, and more using natural language, with authentication handled for you.

Onesignal user auth logoOnesignal user auth
Api Key

OneSignal is a customer engagement platform for push notifications, email, SMS, and in-app messaging. It streamlines how businesses reach, engage, and retain their users across channels.

64 Tools

Introduction

Atomic Agent is an open-source AI agent that runs on your machine and supports local models through llama.cpp. Connect it to 1,700+ apps through Composio, including Onesignal user auth.

This guide uses Atomic Agent's built-in Composio integration. You need Atomic Agent v0.5.6 or later, your own Composio API key, and a Onesignal user auth account. See the Atomic Agent documentation for installation instructions.

For exact tool slugs and parameter tables, see the tool catalog in the Composio docs.

Also integrate Onesignal user auth with

How Atomic Agent connects to Onesignal user auth

Atomic Agent connects to Composio's Tool Router over Streamable HTTP MCP. It discovers the tools needed for your request, and Composio handles account authentication.

Execution and account-connection tools follow Atomic Agent's configured approval policy. Review any approval prompt before allowing an action on your connected account.

Connect Onesignal user auth to Atomic Agent

  1. Sign up or sign in to the Composio dashboard. Copy your API key.
  2. In Atomic Agent, open the Integrations tab and select Composio. Select API key, press e, paste the key, and press Enter. The tools become available immediately, without a restart.
  3. Ask Atomic Agent to do something in Onesignal user auth. It searches Composio for the right tool.
  4. On first use, open the sign-in link returned in the chat. Connect your Onesignal user auth account, then return to Atomic Agent to continue.

Headless setup

Add the following line to ~/.atomic-agent/.env, replacing YOUR_COMPOSIO_API_KEY with your key. Start Atomic Agent after saving the file.

bash
COMPOSIO_API_KEY=YOUR_COMPOSIO_API_KEY

What is the Onesignal user auth MCP server, and what's possible with it?

The Onesignal user auth MCP server is an implementation of the Model Context Protocol that connects your AI agent and assistants like Claude, Cursor, etc directly to your Onesignal user auth account. It provides structured and secure access to your Onesignal workspace, so your agent can perform actions like managing device tags, updating player records, inspecting app segments, and retrieving device information on your behalf.

  • Device tag management: Assign or update custom tags on OneSignal devices to enable powerful audience segmentation and personalized messaging.
  • Edit device/player attributes: Update details or attributes for any registered device (player) in your OneSignal app using your agent.
  • Segment inspection and listing: Retrieve details for specific segments or list all segments in your app to optimize and analyze your audience targeting strategies.
  • Device and app information retrieval: Look up detailed information about individual devices or your entire OneSignal app configuration as needed.
  • View device tags and metadata: Fetch all key/value tags assigned to a particular player for deeper insight into user attributes and behaviors.

Use Onesignal user auth from Atomic Agent

With your account connected, ask Atomic Agent to work with Onesignal user auth in natural language. You can connect more apps through the same Composio integration as you need them.

Visit the Atomic Agent website or inspect the Atomic Agent source code.

Troubleshooting

Why is my API key rejected?

Copy the key directly from the Composio dashboard. Atomic Agent requires ASCII characters because it sends the key in an HTTP header. Remove any extra characters introduced when copying.

Why are Composio tools unavailable after saving a key?

Check that you use Atomic Agent v0.5.6 or later and that Composio is enabled in your configuration. A "composio": { "enabled": false } setting disables the integration while keeping the saved key on disk.

Does Composio have a free plan?

The Hobby plan includes 100,000 tool calls per month. Composio-managed OAuth apps have a lower included allowance. See Composio pricing for the current limits that apply to your connection.

TOOLS

Supported Tools

Every Onesignal user auth action and event your agent gets out of the box.

Bulk Update Message State

Update read, opened, or deleted state for a user's inbox messages in bulk.

Cancel Message

Stop a scheduled or currently outgoing OneSignal message.

Copy Template to Another App

Duplicate a message template into another app in the same organization.

Create Alias by Subscription

Create or update aliases for a user identified by a known Subscription ID.

Create App

Create a OneSignal app with optional web, Android, and iOS push configuration.

Create Custom Events

Record user events for Journeys, segments, personalization, and conversions using the app API key.

Create Inbox Broadcast

Broadcast a message to users' OneSignal inboxes.

Create Journey

Create a draft OneSignal Journey using the beta Journeys API.

Create or Update Alias

Add or update aliases on an existing OneSignal user using an App API key.

Create Segment

Create an audience segment using user-property filters and AND/OR logic.

Create Subscription

Attach an email, SMS or push subscription to an existing user using an App API key.

Create Template

Create a reusable push, email, or SMS template in a OneSignal app.

Create or Update OneSignal User

Tool to create a new user or modify the subscriptions associated with an existing user.

Delete User Alias

Tool to remove an alias from a OneSignal user.

Delete Segment

Permanently delete a OneSignal segment without deleting users or subscriptions.

Delete Subscription

Delete a single OneSignal subscription using the app's App API key.

Delete Template

Permanently delete a message template from a OneSignal app.

Delete User

Permanently delete a OneSignal user using the app's App API key.

Duplicate Journey

Copy an existing OneSignal Journey into a new draft using the beta Journeys API.

Edit OneSignal Device

Tool to update an existing OneSignal device (player) record.

Estimate Recipients

Estimate recipient counts for segment-based targeting without creating or sending a notification.

Export Audience Activity

Start a compressed CSV export of a push, email, or SMS message's audience delivery and engagement events.

Export Subscriptions CSV

Request an asynchronous GZip CSV export of subscription data and return its URL without downloading or polling.

Get Email Provider Metrics

Get email delivery and engagement counts by inbox provider for a sending domain.

Get Email Provider Metrics Timeseries

Get email delivery and engagement counts for a sending domain over time.

Get Email Reputation Statistics

Read email bounce and spam complaint rates for a OneSignal app.

List Audit Logs

Retrieve one time-scoped page of organization audit log events.

Message History

Request an asynchronous export of subscriptions sent or clicking a push notification or email within seven days of sending.

View OneSignal Segment

Tool to retrieve the subscriber count for a specific OneSignal segment.

Send Email

Send an email through OneSignal to aliases, subscriptions, addresses, segments, or filters.

Send Push Notification

Send a push notification to selected OneSignal users or subscriptions.

Send SMS

Send an SMS or MMS using OneSignal.

Start Live Activity

Remotely start an iOS Live Activity.

Transfer Subscription

Transfer a push, email, or SMS subscription to another user in the same app.

Unsubscribe Email With Token

Unsubscribe an email subscription using a token from a custom unsubscribe page.

Update App

Update an existing OneSignal app's name or push platform configuration.

Update Journey

Partially update a draft OneSignal Journey using JSON Merge Patch.

Update Journey Node

Partially update one node of a draft OneSignal Journey (beta).

Update Live Activity

Update or end a running iOS Live Activity on every device registered under its topic key.

Update Message State

Update the read, opened, or deleted state of one user's inbox message.

Update Segment

Update a OneSignal segment using an App API key.

Update Subscription

Update an existing OneSignal subscription by its immutable subscription ID.

Update Subscription By Token

Tool to update properties on an existing subscription using its token.

Update Template

Update an existing push, email, or SMS message template.

Update User

Update an existing OneSignal user's profile properties using an App API key.

View API Keys

List metadata for all current API keys belonging to a OneSignal app.

View App

Tool to retrieve details for a specific OneSignal app.

View Apps

List OneSignal apps with metadata, subscription counts and platform configuration.

View Broadcasts

Tool to view inbox broadcasts for a OneSignal app.

View OneSignal Device

Tool to retrieve details for a specific device/player.

View Identity By Subscription

Retrieve all aliases for a OneSignal user by subscription using an App API key.

View Journey

Retrieve a journey's full audience, schedule, lifecycle rules, and node graph.

View Journeys

List one page of Journey summaries for a OneSignal app, newest first.

View Journey Stats

Retrieve all-time performance stats for one Journey (Beta).

View Message

Read one push, email, or SMS message and optionally its outcome metrics.

View Messages

Read one bounded page of push, email, or SMS messages for a OneSignal app.

View Outcomes

Tool to view all outcomes associated with a OneSignal app.

View Segments

Tool to list all segments for an app.

View Template

Retrieve one push, email, or SMS message template by its template ID.

View Templates

List one bounded page of message template summaries for a OneSignal app.

View OneSignal User

Tool to retrieve user details by alias label and ID.

View User Broadcasts

Read one page of inbox broadcasts received by a OneSignal user.

View User Identity

Retrieve all aliases for a OneSignal user using an App API key.

View User Unread Message Count

Retrieve the unread inbox message count for a user identified by alias.

FAQ

Frequently asked questions

Start with Onesignal user auth.It takes 30 seconds.

Managed auth, hosted MCP servers, and every Onesignal user auth tool your agent needs.Free to start.

Start building