# Customer.io MCP for AI Agents AI Agent Connect > Customer.io gives your AI agent the ability to manage customer engagement, run automated marketing campaigns, and track messaging metrics directly through the Customer.io API. It connects your marketing data to your AI workspace so you can update profiles, audit campaign performance, and check audience segments using plain English. ## Overview - **Category:** productivity - **Price:** Free - **Endpoint:** https://edge.vinkius.com/vk_preview_pB5Glq19S2AlhJCYRGobJWZEWZYTGA1BNGjmWvM6/ai-agent-connect - **Tags:** customer-io, marketing-automation, lifecycle-marketing, campaign-tracking, segmentation-api, email-marketing, transactional-email, growth-tools, mcp ## Description This Connector connects Customer.io to your AI workflow so you can handle customer engagement without jumping between tabs. Instead of manually hunting for profile data or checking if a campaign actually hit its targets, you can just ask your agent to do the heavy lifting. You can update customer attributes on the fly, pull performance summaries for your newsletters, and see which segments are growing. It makes the data inside your marketing platform actually usable in a conversation. Imagine a situation where you need to quickly audit your retention efforts. Instead of opening a browser and filtering through rows of data, you can ask your agent to summarize your recent broadcast performance. You get the numbers you need to make a decision in seconds. If you're looking for a way to bridge the gap between your customer data and your daily tasks, this is how you do it. You can find this and thousands of other integrations in the Vinkius catalog to get your environment set up quickly. It's about moving away from manual data entry and toward a system where your agent knows who your customers are and how they're interacting with your brand. It turns your marketing database into a living resource that your agent can query to provide better support and smarter growth strategies. ## Tools ### list_transactional_messages g. password resets). List 1-to-1 messages ### get_connection_status Check API health ### get_campaign_performance Get delivery and engagement metrics for a specific campaign. Use this to see how many people opened or clicked your messages. ### list_segment_members Get people in segment ### list_scheduled_broadcasts List one-to-many messages ### list_active_campaigns List automated campaigns ### list_newsletters List all newsletter campaigns. Use this to check the status of your content distribution. ### list_audience_segments List user segments ### send_transactional_email Send individual email ### dispatch_broadcast Trigger manual broadcast ### get_customer_details Get full profile data, attributes, and device tokens for a specific customer. This gives your agent the context it needs to be helpful. ### list_customers List all customers and people in your Customer.io workspace. This gives you a broad view of your entire audience. ## Prompt Examples **Prompt:** ``` List all active automated campaigns. ``` **Response:** ``` I've checked your Customer.io account and found the following active automated campaigns: * **Welcome Sequence** (ID: 102) * **Abandoned Cart Recovery** (ID: 450) * **Monthly Retention** (ID: 882) Would you like me to pull the engagement metrics for any of these? ``` **Prompt:** ``` Show me the performance metrics for the 'Welcome Sequence' campaign. ``` **Response:** ``` Here are the metrics for the **Welcome Sequence** (ID: 102) for this month: | Metric | Value | | :--- | :--- | | **Total Entries** | 1,240 | | **Open Rate** | 48.2% | | **Click Rate** | 9.5% | | **Conversions** | 112 | Should I compare these numbers to last month's performance? ``` **Prompt:** ``` Identify a new customer with ID 'user_789' and email 'new.user@example.com'. ``` **Response:** ``` I've successfully updated the profile for **user_789**. * **Email:** new.user@example.com * **Status:** Identified * **Timestamp:** Just now Is there any other behavioral data or custom attributes you'd like me to add to this profile? ``` ## Capabilities ### Update customer profiles Modify customer attributes and behavioral data using the identify_customer tool. ### Pull campaign stats Get delivery and engagement metrics for any campaign using get_campaign_performance. ### Check engagement summaries Retrieve a high-level summary of campaign and broadcast performance with get_engagement_summary. ### See customer details Get full profile data and device tokens for a specific customer using get_customer_details. ### List broadcast messages View all one-to-many broadcast messages in your account with list_broadcast_messages. ### View automated campaigns List all automated messaging campaigns and their trigger types with list_automated_campaigns. ### See newsletter status List all newsletter campaigns and their current statuses with list_newsletters. ### View customer lists See all customers and people in your workspace with list_customers. ### Explore audience segments List all dynamic and manual segments to see how your audience is grouped with list_customer_segments. ### Find customers by email Search for a specific customer profile using an email address with search_customers_by_email. ## Use Cases ### Updating a user's status after a purchase A growth engineer needs to update a user's behavior score after a specific action. They ask the agent to identify the customer and add the new attribute. ### Checking if a newsletter reached its target A marketing manager wants to know how the last newsletter performed. They ask the agent to pull a summary of the engagement metrics. ### Finding a customer for a support ticket A support agent needs to find a user's history quickly. They ask the agent to search for the customer by email and show their full profile. ### Auditing segment sizes for a new launch A retention lead wants to see the size of their 'At Risk' segment. They ask the agent to list all customer segments to find the right one. ## Benefits - Update customer profiles instantly with identify_customer to keep your data clean. - Check campaign success rates using get_campaign_performance to see what's actually working. - Get a quick overview of results with get_engagement_summary for fast reporting. - Pull full profile data using get_customer_details to provide better support. - Monitor one-to-many messages with list_broadcast_messages to stay on top of your outreach. - Audit your automation list with list_automated_campaigns to ensure your triggers are correct. ## How It Works The bottom line is you get a direct line from your AI agent to your marketing data. 1. Connect the Customer.io integration to your AI client. 2. Enter your Site ID and API Key from your Customer.io settings. 3. Ask your agent to pull stats, update profiles, or summarize segments. ## Frequently Asked Questions **Can I use Customer.io MCP to update user data?** Yes, you can use it to create or update customer profiles with specific attributes. This is great for keeping your records current as users interact with your brand. **How do I see my campaign stats?** You can ask your agent to pull performance metrics or a high-level summary for any campaign. It will show you things like open rates and click counts instantly. **Can it find customers by email?** Yes, the Connector can search for a specific customer profile using their email address. This makes it easy to pull up a user's details for support or marketing checks. **Does this work for newsletter tracking?** It does. You can list your newsletter campaigns and check their status or pull engagement summaries to see how they're performing. **Can I see my audience segments?** Yes, you can ask the agent to list all your dynamic and manual segments. It will show you the segment IDs, types, and how many people are in each group. **Can I manage my automated messages with Customer.io MCP?** You can list all your automated campaigns and broadcast messages. This helps you keep an eye on what's currently active in your marketing workflow. **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. **How do I find my Customer.io App API Key?** Log in to Customer.io, navigate to **Settings** > **Account Settings** > **API Keys**, and select the **App API Keys** tab to generate a new token. **Does it support EU regional accounts?** Yes! You can specify your region ('us' or 'eu') via the `CUSTOMER_IO_REGION` credential to ensure the agent connects to the correct data center. **Can I trigger a broadcast via AI?** Yes! Use the `dispatch_broadcast` tool with a specific broadcast ID. You can optionally provide JSON parameters for Liquid data injection.