Customer.io MCP. Diagnose campaign drops and manage customer profiles via chat.
Gemini Works with every AI agent you already use
…and any MCP-compatible client
Just plug in your AI agents and start using Vinkius.
Customer.io MCP Server connects your AI agent directly to your customer engagement data. Manage profiles, track campaigns, and monitor messaging metrics by invoking specific tools.
You can update customer records, list segments, get campaign performance, and track newsletters using natural language commands.
What your AI agents can do
Get campaign performance
Gets the delivery, open, click, and conversion counts for a specific campaign.
Get customer details
Retrieves a customer's full profile, including custom attributes, device tokens, and segment memberships.
Get engagement summary
Pulls a high-level summary of performance for all campaigns and broadcasts.
Retrieves a customer's attributes, devices, and segment memberships for deep profile analysis.
Calculates delivery, open, click, and conversion counts for specific automated campaigns.
Creates or modifies a customer's profile record by adding behavioral attributes.
Retrieves all existing customer segments, whether they are dynamic or manually defined.
Pulls summary key performance indicators for overall campaign and broadcast activity.
Searches for a customer's profile using their email address.
Ask AI about this MCP
Supported MCP Clients
Gemini Waiting for input…
Customer.io MCP Server: 10 Tools for Campaign & Segment Ops
These tools let your AI client interact with Customer.io to manage customer profiles, list segments, and pull detailed campaign performance metrics.
019d7580get campaign performance
Gets the delivery, open, click, and conversion counts for a specific campaign.
019d7580get customer details
Retrieves a customer's full profile, including custom attributes, device tokens, and segment memberships.
019d7580get engagement summary
Pulls a high-level summary of performance for all campaigns and broadcasts.
019d7580identify customer
Creates or updates a customer profile by setting attributes for a given ID.
019d7580list automated campaigns
Lists all active automated messaging campaigns available in the workspace.
019d7580list broadcast messages
Lists all one-to-many broadcast messages and their scheduling details.
019d7580list customer segments
Lists all dynamic and manual audience segments you've created.
019d7580list customers
Lists every customer record in your workspace by ID, email, and last seen time.
019d7580list newsletters
Lists all newsletter campaigns and their current status.
019d7580search customers by email
Finds a specific customer's profile using just their email address.
Choose How to Get Started
Build a custom MCP for your own tools, or connect a ready-made integration from our catalog.
Build Your Own
Turn any API into an MCP. Import a spec, define Agent Skills, or deploy with MCPFusion.
- Import from OpenAPI, Swagger, or YAML specs
- Create Agent Skills with progressive disclosure
- Deploy to edge with MCPFusion framework
- Built in DLP, auth, and compliance on every call
- Real time usage dashboard and cost metering
- Publish to catalog or keep private
Make Your AI Do More
Start with Customer.io, then connect any of our 4,700+ other servers whenever your AI needs more. One click, no limits.
- Use this MCP plus 4,700+ others, all in one place
- Add new capabilities to your AI anytime you want
- Every connection is secured and compliant automatically
- Track usage and costs across all your servers
- Works with Claude, ChatGPT, Cursor, and more
- New servers added to the catalog every week
What you can do with this MCP connector
Your AI agent connects straight to Customer.io. You manage user profiles, track campaigns, and monitor messaging metrics just by talking to it. When you need to know about a customer, you can use search_customers_by_email to find their profile using just their email address. You can also use list_customers to pull a list of every customer in the workspace, seeing their ID, email, and last seen time.
To get deep profile analysis, call get_customer_details, which pulls a customer's full profile, including their custom attributes, device tokens, and segment memberships. If you need to update a record, use identify_customer to create or modify a customer's profile by setting specific attributes for a given ID. For audience scope, you can pull all customer segments—whether they're dynamic or manually defined—using list_customer_segments.
You can also pull a list of all automated messaging campaigns with list_automated_campaigns and see the status of all newsletter campaigns with list_newsletters. When it comes to performance, you can get a high-level summary of all campaigns and broadcasts by running get_engagement_summary. To track specific campaign metrics, use get_campaign_performance to get the delivery, open, click, and conversion counts for a specific campaign.
You can list all one-to-many broadcast messages and their scheduling details by calling list_broadcast_messages.
How Customer.io MCP Works
- 1 Connect the Customer.io integration to your AI agent and provide the necessary Site ID and API Key.
- 2 The agent uses a tool like
list_automated_campaignsto show available campaigns and segment IDs. - 3 You ask the agent to perform an action (e.g., 'Check the performance of the Welcome Sequence'), and the agent executes the specific tool call.
The bottom line is, you manage customer data and campaign performance through conversation, not by clicking through dashboards.
Who Is Customer.io MCP For?
Growth Engineers who need to programmatically update customer data; Retention Marketers who need to audit campaign performance quickly; and Support Specialists who need to pull a user's complete history to solve a problem fast. This tool cuts out the manual reporting steps.
Runs diagnostic queries like 'Why did the open rate drop last week?' by comparing metrics using get_campaign_performance and analyzing segment changes via list_customer_segments.
Uses identify_customer to enrich raw data feeds, ensuring every new user record gets the correct attributes before triggering a campaign.
Pulls a customer's full record, including device tokens and messaging history, using get_customer_details to give personalized support.
What Changes When You Connect
- Pinpoint performance drops immediately. Instead of guessing, you ask the agent to run
get_campaign_performanceand get precise counts for opens, clicks, and conversions. - Keep customer data current. Use
identify_customerto enrich user profiles instantly. You can add behavioral attributes to any user without jumping into the UI. - Understand your audience structure. Running
list_customer_segmentsshows you exactly which groups exist and how many people are in each one, allowing for better targeting. - Manage large-scale messaging. You can list all one-to-many broadcasts with
list_broadcast_messagesand see their scheduling metadata without touching the main dashboard. - Get a quick performance snapshot. Need to know if your overall campaigns are doing okay?
get_engagement_summaryprovides the high-level KPIs fast. - Deep dive into users. The
get_customer_detailstool pulls everything about a user—attributes, device tokens, and segments—so you don't have to check three different tabs.
Real-World Use Cases
Investigating a recent drop in open rates
The marketing analyst sees a drop in opens. They ask their agent to run get_campaign_performance for the affected campaign. The agent reports the drop and then suggests running list_customer_segments to see if the segment definition changed, solving the diagnostic problem.
Onboarding a new user and setting up tracking
A growth engineer signs up a new client. They ask the agent to identify_customer with the new user's ID and initial attributes. The agent updates the profile, guaranteeing the user is tracked and included in the correct campaigns.
Finding all users who saw a specific campaign
A support lead needs to verify a customer's history. They use search_customers_by_email to find the ID, then use get_customer_details to pull the full profile and messaging history for personalized assistance.
Planning a new broadcast sequence
The campaign manager wants to see what's available. They ask the agent to run list_automated_campaigns and list_newsletters back-to-back. This gives them a full inventory of all messaging types before drafting anything.
The Tradeoffs
Checking data piece by piece
Manually navigating to the Campaign tab, then the Segment tab, then the Customer tab to piece together a user's journey. This takes 20 minutes of clicking and copy-pasting.
→
First, use search_customers_by_email to get the ID. Then, ask the agent to get_customer_details to pull the full record. Finally, ask the agent to get_campaign_performance to see if the metrics match the user's segment.
Assuming data is complete
Running a simple list of customers (list_customers) and assuming the attributes are current. You might miss critical behavioral data needed for targeting.
→
Always run identify_customer first to check the current profile state, or use get_customer_details to confirm the most recent attributes and device tokens.
Mixing up messaging types
Trying to compare the performance of a general broadcast message against a targeted automated campaign, leading to incorrect metric comparisons.
→
Use get_campaign_performance for automated flows, and use list_broadcast_messages and get_engagement_summary for bulk, one-to-many messaging.
When It Fits, When It Doesn't
Use this MCP Server if you need to correlate multiple pieces of customer data—like linking a user's profile attributes (get_customer_details) to a specific campaign's performance (get_campaign_performance)—in a single conversational flow. This is for diagnostics and data enrichment.
Don't use it if your only goal is to generate a simple report or pull a single list. If you just need a list of all users, list_customers works. If you only need to see what campaigns exist, list_automated_campaigns is enough. The power here is the linking, not the viewing.
Independent Platform Disclaimer: Vinkius is an independent platform and is not affiliated with, endorsed by, sponsored by, verified by, or otherwise authorized by Customer.io. All third-party trademarks, logos, and brand names are the property of their respective owners. Their use on this website is strictly for informational purposes to identify service compatibility and interoperability.
VINKIUS INFRASTRUCTURE
Cloud Hosted
Managed infra
V8 Isolated
Sandboxed per request
Zero-Trust Proxy
No stored credentials
DLP Enforced
Policy on every call
GDPR Compliant
EU data residency
Token Compression
~60% cost reduction
Works with Claude, ChatGPT, Cursor, and more
The Model Context Protocol standardizes how applications expose capabilities to LLMs. Instead of operating in isolation, your AI gains direct access to external platforms, live data, and real-world actions through secure, standardized connections.
This server provides 10 capabilities that interface natively with Claude, ChatGPT, Cursor, and any MCP client. No middleware. No custom integration required.
Available Capabilities
Trying to piece together a customer's journey across five different dashboards.
Today, tracing a single customer's journey means clicking from the segment dashboard to the campaign reports, then manually checking the individual user profile. You copy the segment ID, paste it into the campaign tool, and then jump to the user view to see if the data lines up. It's a tedious loop of clicking and copy-pasting.
With this MCP Server, you just tell your agent: 'Show me the performance for Campaign X for users in Segment Y.' The agent runs `get_campaign_performance` and filters the results using the data from `list_customer_segments`. You get the answer without leaving the chat window.
Customer.io MCP Server: Get the full user story from chat.
Before, you needed to open the user profile, then open the campaign report, and then manually cross-reference the email address in both places. This process alone takes five minutes and requires multiple logins.
Now, you ask the agent to `get_customer_details` for a user. It pulls the full profile, the attributes, and the segment data in one go. You get the full picture, instantly.
Common Questions About Customer.io MCP
How do I use the get_campaign_performance tool with Customer.io? +
The get_campaign_performance tool calculates the delivery, open, click, and conversion counts for a specific campaign. You just need to provide the campaign ID to the agent.
Can I find a customer by email using the Customer.io MCP Server? +
Yes. Use search_customers_by_email. It looks up the associated customer identifier and gives you the profile data you need.
What is the difference between list_customers and get_customer_details? +
Use list_customers to see a list of all available user IDs and emails. Use get_customer_details when you already have a specific user ID and need all their detailed attributes.
How do I list all my available customer segments? +
Run list_customer_segments. This tool shows you all the existing dynamic and manual segments you can target.
When should I use the identify_customer tool instead of search_customers_by_email? +
Use identify_customer when you need to create or update a profile. This tool mutates the customer identity database, allowing you to add attributes or correct data. search_customers_by_email just finds an existing profile.
How can I use list_customer_segments to check segment membership? +
The list_customer_segments tool shows all segments, including dynamic and manual ones. You can then use your AI client to determine if a specific user belongs to a segment based on their attributes.
What happens if I call get_customer_details for a customer who doesn't exist? +
The system returns an error indicating the customer ID is invalid. Your AI client handles this gracefully, allowing you to retry the call with the correct identifier. You'll get a clear error message.
Do I need to list_all_automated_campaigns before I can check performance with get_campaign_performance? +
No. You can run get_campaign_performance directly by providing the Campaign ID. The tool only needs the ID to retrieve the necessary metrics. Listing campaigns is optional context.
How do I get a Customer.io API Key? +
Log in to your Customer.io workspace, navigate to Settings > API Keys, and you will find your Site ID and API Key there. You can create different keys for tracking and management purposes.
Can the agent trigger a campaign manually? +
This integration currently focuses on identifying customers and monitoring campaign data. Triggering campaigns is typically done via behavioral events or within the Customer.io workflow builder.
Does the integration support SMS and Push notifications? +
Yes, Customer.io is a multi-channel platform. The agent can monitor campaigns and broadcasts that include Email, SMS, Push, and Webhook actions.
Use it with your favorite AI tools
Connect this server to Cursor, Claude, VS Code, and more.
More in this category
Lemlist
Equip your AI agent with direct access to Lemlist — manage cold email campaigns, track lead engagement, and automate outreach without opening the Lemlist dashboard.
Dripcel
Equip your AI agent to manage WhatsApp instances, track contacts, and monitor messaging automation via the Dripcel API.
Brandwatch
Access consumer research via Brandwatch — list projects, track queries, and retrieve social mentions directly from any AI agent.
You might also like
AT&T Messaging
CPaaS Messaging -- Send SMS/MMS, manage shortcodes, track delivery status, and run bulk campaigns via AT&T Messaging API.
Zoho Invoice
Manage customers, create invoices, and automate billing on Zoho Invoice — the clean and simple invoicing software for small business.
Onpipeline
Track deals through your sales pipeline with a visual CRM that focuses on activity-based selling and revenue forecasting.