How to integrate Customerio MCP with Atomic Agent

Connect Atomic Agent to Customerio MCP. List all segments in your workspace, get delivery metrics for last week's emails, and more using natural language, with authentication handled for you.

Customerio logoCustomerio
Api Key

Customer.io is a customer engagement platform for targeted messaging across email, SMS, and push. Easily automate, segment, and track communications with your audience.

39 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 Customerio.

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 Customerio 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 Customerio with

How Atomic Agent connects to Customerio

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 Customerio 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 Customerio. It searches Composio for the right tool.
  4. On first use, open the sign-in link returned in the chat. Connect your Customerio 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 Customerio MCP server, and what's possible with it?

The Customerio MCP server is an implementation of the Model Context Protocol that connects your AI agent and assistants like Claude, Cursor, etc directly to your Customer.io account. It provides structured and secure access to your customer engagement workspace, allowing your agent to send targeted communications, manage segments, retrieve messaging analytics, and automate customer data management on your behalf.

  • Targeted message analytics and tracking: Retrieve detailed lists of messages sent, including delivery metrics, to monitor campaign performance and engagement.
  • Segment discovery and membership management: Let your agent fetch all segments, get details for a specific segment, and list all customers in a segment for precise audience targeting.
  • Integration and webhook management: Have your agent list and review all integrations and webhooks in your workspace to streamline system connectivity and reporting.
  • Customer profile suppression: Direct your agent to permanently suppress (delete and block) customer profiles, ensuring compliance and data privacy.
  • Collection metadata retrieval: Retrieve up-to-date details for all collections in your workspace, keeping your AI-powered workflows and automations in sync with your data sources.

Use Customerio from Atomic Agent

With your account connected, ask Atomic Agent to work with Customerio 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 Customerio action and event your agent gets out of the box.

Add Person to Group

Add a person to a Customer.io group to establish a relationship with an object such as a company, account, or project.

Author, Version, and Publish Email

Update and version a linked Design Studio email, then publish it.

Create Profile Alias

Create an alias to merge Customer.io profiles for a person with multiple identifiers.

Create Segment

Create an empty manual segment in Customer.io.

Suppress Customer Profile

Suppress a customer profile to permanently delete it and prevent re-adding with the same identifier.

Find Customers by Email

Return Customer.io profiles whose email exactly matches the provided address.

Get Account Region

Return the region and Track API URL for the connected Customer.io account.

Get Customer Attributes

Return one Customer.io profile's attributes and devices.

Get Integrations

Retrieve a list of integrations in your workspace to discover configured integrations.

Get Messages

Tool to retrieve a list of messages sent from your workspace.

Get Newsletter Content Metrics

Retrieve engagement metrics for a Customer.io one-time send variant.

Get Newsletter Metrics

Retrieve aggregate engagement metrics for a Customer.io one-time send.

Get Segment Customer Count

Return the current number of profiles in a Customer.io segment.

Get Segment Details

Tool to retrieve details of a specific segment.

Get Segment Membership

Tool to retrieve people in a specific segment.

Get Segments

Tool to retrieve a list of segments in your workspace.

Get Transactional Metrics

Return aggregate engagement metrics for a transactional message template.

Get Trigger

Retrieves details about a specific API-triggered broadcast, including trigger ID, campaign ID, creation timestamp, recipient filter criteria, and personalization data.

Get Broadcast Triggers

Retrieve all API trigger instances for a specific broadcast/campaign.

Get Customer.io Workspace Webhooks

Retrieves all reporting webhook configurations from the Customer.io workspace.

Identify Person

Identify a person in Customer.io and assign traits, creating a profile or updating an existing one.

List Activities

Return recent workspace activity-log entries with optional filters.

List Campaigns

Return Customer.io automations and their metadata.

List Collections

Tool to list all Collections metadata.

List Customer Attributes

Return attributes and devices for up to 100 Customer.io profiles.

List IP Addresses

Tool to retrieve the list of IP addresses used by Customer.io for sending messages.

List Newsletters

Tool to list all newsletters.

List Snippets

Tool to list all snippets in your workspace.

List Transactional Contents

Return every language and content variant of a transactional template.

List Transactional Messages

Lists all transactional message templates in your Customer.io workspace.

List Workspaces

List Customer.io workspaces and their cached usage counts.

Preview Email

Evaluate a Design Studio email against sample Liquid data without sending.

Search Customers

Search Customer.io profiles using an audience filter.

Send Batch CDP Calls

Send multiple CDP calls (identify, track, page, screen, group, alias) in a single batch request.

Track Event

Tool to send an event associated with a person in Customer.io.

Track Page View

Track page views for website visitors through the Customer.io CDP API, providing a user ID or anonymous ID and optional page properties.

Track Screen View

Track mobile screen views in Customer.io for analytics and user journey tracking.

Trigger Broadcast

Manually trigger a Customer.io broadcast/campaign to send messages to a defined audience.

Unsubscribe from Delivery

Tool to handle custom unsubscribe requests for email deliveries in Customer.io.

FAQ

Frequently asked questions

Start with Customerio.It takes 30 seconds.

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

Start building