# Customer.io MCP for AI Agents MCP

> The Customer.io MCP lets your AI agent handle complex marketing automation tasks. You can programmatically manage entire customer profiles, track real-time campaign performance (including opens and clicks), list all automated sequences, and segment audiences based on behavior—all without leaving your chat interface.

## Overview
- **Category:** marketing-automation
- **Price:** Free
- **Tags:** automated-messaging, behavioral-targeting, customer-engagement, campaign-management, personalization, email-marketing

## Description

This connector brings Customer.io's full suite of marketing tools right to your AI workflow. Instead of logging into the platform, navigating multiple tabs, and manually compiling reports, your agent handles the heavy lifting using natural language prompts.

Need to know how a new segment is performing? Ask your agent for a high-level summary or dive deep by listing all automated campaigns. Need an update on a single user's history? Your agent can retrieve full customer profiles and attributes instantly. This means your team gets immediate visibility into campaign status, audience composition, and individual engagement metrics—all through conversation. You simply connect the Customer.io integration via Vinkius to your AI client and start working.

It’s about getting data, action, and insights without ever leaving your chat window.

## Tools

### identify_customer
Creates or updates a customer's profile by adding specific attributes.

### get_campaign_performance
Retrieves key metrics, including open, click, and conversion counts for an automated campaign.

### get_engagement_summary
Provides a quick overview of high-level performance across all marketing campaigns and broadcasts.

### get_customer_details
Pulls the complete profile, behavioral data, and associated device tokens for a single customer.

### list_broadcast_messages
Lists all one-to-many broadcast messages and their scheduling metadata.

### list_automated_campaigns
Retrieves the list of all automated messaging campaigns, including their IDs and trigger types.

### list_newsletters
Lists all available newsletter campaigns and checks their distribution status.

### list_customers
Provides a list of every customer in your workspace, including their email and last seen timestamp.

### list_customer_segments
Lists all audience segments, showing whether they are manual or dynamic, along with member counts.

### search_customers_by_email
Finds and resolves a customer profile using only their email address.

## Prompt Examples

**Prompt:** 
```
Show me which of my top three segments are underperforming right now.
```

**Response:** 
```
**Segment Performance Audit**

| Segment Name | Members Count | Open Rate (This Mo) | Click Rate (This Mo) |
| :--- | :--- | :--- | :--- |
| High Intent Buyers | 1,200 | 45% | 8.2% |
| Welcome Series Group | 3,500 | 32% | 6.1% |
| Basic Leads | 7,800 | 15% | 2.5% |

The 'Basic Leads' segment needs attention; their click rate is significantly lower than average.
```

**Prompt:** 
```
What are the most common attributes for customers who signed up last month?
```

**Response:** 
```
**Customer Attributes Snapshot**

I checked 50 recent profiles. The top attributes we see include:
*   Signup Source: Organic Search (42%)
*   Industry Focus: SaaS (38%)
*   Last Activity: Product Tour Completion (15%) 

You can use this data to refine your targeting strategy.
```

**Prompt:** 
```
List all active campaigns and what their last reported status was.
```

**Response:** 
```
**Automated Campaign Status**

Here are the 4 active sequences:
1.  'Welcome Sequence': **Running**. Last check: Open Rate 32%. 
2.  'Abandoned Cart Recovery': **Paused**. Needs review.
3.  'Monthly Retention Blast': **Scheduled**. Next send: Oct 5th.
4.  'Trial Expiration Nudge': **Active**. High engagement.
```

## Capabilities

### Update and Create Profiles
The agent can create or update a customer's profile attributes using the identify_customer tool.

### Analyze Campaign Performance Metrics
You can get detailed delivery and engagement metrics for specific automated campaigns using get_campaign_performance.

### Review Overall Engagement Summary
Retrieve a high-level summary of performance across all campaigns and broadcasts with get_engagement_summary.

### Manage Audience Segmentation
List dynamic or manual segments and retrieve the full list of customers using list_customer_segments.

### Gather Full User Details
Get comprehensive profiles, attributes, and device tokens for any specific customer with get_customer_details.

### Audit Messaging History
List all scheduled one-to-many broadcast messages using list_broadcast_messages.

## Use Cases

### Investigating a low open rate for the welcome series
A user asks, 'Why is my new welcome sequence underperforming?' The agent calls get_campaign_performance on the specific campaign ID. It reports that while sends were high, the engagement summary shows poor click-through rates compared to previous months.

### Updating a profile after an in-app purchase
The sales team needs to make sure a new customer is correctly categorized. They prompt the agent to identify_customer, passing the user's ID and noting 'Premium Tier Purchased,' ensuring all future campaigns target them correctly.

### Checking who is eligible for a retention offer
Instead of filtering in the web UI, the user asks the agent to list_customer_segments. The agent returns a count and name for 'High Value, Inactive,' allowing the team to immediately send targeted communications.

### Gathering data on all marketing efforts
The manager needs an overview of everything. They ask the agent to get_engagement_summary, which pulls high-level KPIs across both automated campaigns and general broadcast messaging statuses.

## Benefits

- Audit campaign performance instantly: Use get_campaign_performance to see real-time open and click rates without navigating dashboards.
- Maintain a single source of truth for customers: The identify_customer tool lets your agent update profiles with new behavioral data immediately.
- Understand audience composition easily: List all dynamic or manual segments via list_customer_segments, so you know exactly who's in each group.
- Quickly find user accounts: Instead of guessing an ID, use search_customers_by_email to pull up a full record using get_customer_details.
- Monitor outreach efforts: You can review all scheduled broadcasts and newsletters by calling list_broadcast_messages or list_newsletters.

## How It Works

The bottom line is you get immediate access to core marketing metrics and customer data without manual API calls or platform navigation.

1. Connect the Customer.io MCP to your AI client and authorize it using your Site ID and API Key.
2. Instruct your agent on the task, whether that's listing all automated campaigns or checking a specific customer’s segment membership.
3. The agent executes the necessary tool calls, retrieves the raw data from Customer.io, and presents the findings in plain language.

## Frequently Asked Questions

**How can the Customer.io MCP help me check my marketing campaign results?**
The MCP lets your agent pull specific, real-time metrics for any automated campaign. Instead of logging into a dashboard and digging through tabs, you just ask your AI client to get the performance summary, and it delivers open rates, click counts, and conversion data instantly.

**I need to update a user profile; is that possible with this MCP?**
Yes. You can use the agent to identify or update customer profiles by passing behavioral attributes like 'Product Viewed' or 'Subscription Tier.' This keeps your data fresh and accurate for future marketing efforts.

**What if I want to target a group of users based on specific actions?**
You can list all dynamic segments using the MCP. The agent will return the names and membership counts, allowing you to confirm that your criteria are capturing the right audience before sending out anything.

**Does Customer.io MCP work for checking broadcast messages?**
Absolutely. You can list all one-to-many broadcast messages using this MCP. This is useful if you need a complete audit trail or want to see the scheduling metadata across all your bulk communications.

**Can I find a user's entire history, not just their email?**
The agent can get comprehensive customer details by using search_customers_by_email. This pulls everything: custom attributes, device tokens, and segment memberships—a full 360-degree view of the person.