# Customer.io MCP MCP > Customer.io connects your AI client directly to your full marketing automation stack. Trigger behavior-driven emails, manage audience segments, and track campaign performance based on what users actually do inside your product. Get instant answers about customer profiles, segment sizes, or open/click rates without leaving your workspace. ## Overview - **Category:** productivity - **Price:** Free - **Tags:** customer-io, marketing-automation, lifecycle-marketing, campaign-tracking, segmentation-api, email-marketing, transactional-email, growth-tools, mcp ## Description You stop manually logging into dashboards just to check a count or run an ad-hoc report. This connection lets your AI agent talk directly to your core customer data, giving you immediate answers about who is active, who needs an email, and how well any campaign ran. Whether you need to coordinate personalized journeys by checking detailed profile attributes for one user or listing thousands of segment members, the system handles it all conversationally. From tracking individual open rates using `get_campaign_performance` to sending a targeted message via `send_transactional_email`, your AI acts as an instant growth marketer coordinator. Because this functionality is hosted on Vinkius, you get access to Customer.io's power alongside thousands of other tools in one place. ## Tools ### get_connection_status Verifies if the connection to Customer.io is active and working correctly. ### get_campaign_performance Checks the performance statistics for specific automated marketing campaigns. ### get_customer_details Retrieves a full, detailed profile for an individual person or account. ### list_segment_members Lists the specific people who are currently members of an audience segment you name. ### list_scheduled_broadcasts Retrieves details about messages that have been scheduled to send out at a future time. ### list_active_campaigns Lists all currently running automated marketing journeys and flows. ### list_newsletters Displays a list of saved message templates or newsletters you've created. ### list_customers Lists and retrieves the names and basic details of your entire audience base. ### list_audience_segments Retrieves a directory of all defined user segments, whether manual or data-driven. ### list_transactional_messages Shows a list of pre-defined, one-to-one message templates used for things like password resets. ### send_transactional_email Sends an individual email to one person using a predefined template. ### dispatch_broadcast Sends a manual message broadcast to an audience within your account. ## Prompt Examples **Prompt:** ``` List all active marketing campaigns in Customer.io. ``` **Response:** ``` I've retrieved your active campaigns. You currently have 3 automated journeys running, including 'Welcome Sequence' and 'Re-engagement Flow'. Would you like the performance metrics for any of these? ``` **Prompt:** ``` Show me the audience segments and their member counts. ``` **Response:** ``` Accessing segments... Your 'Premium Users' segment has 1,240 members, and 'Trial Expired' has 450. I can provide the detailed profile attributes for specific members if needed. ``` **Prompt:** ``` Send a transactional email to 'jane@example.com' (ID: 'trans_123'). ``` **Response:** ``` Message dispatched! I've successfully triggered the transactional email 'trans_123' for Jane Doe. The delivery is now being tracked in your performance logs. ``` ## Capabilities ### Query individual user profiles Get a complete set of attributes and traits for any specific customer profile. ### Identify target audience segments List all available user segment groups or retrieve the exact count of people belonging to a defined group. ### Execute mass communications Send immediate, manual broadcast messages or specific transactional emails to large groups of users. ### Analyze campaign results Retrieve detailed performance data for automated marketing campaigns, including open and click metrics. ### List available communication types View all active automated journeys or saved broadcast templates. ## Use Cases ### Need to verify eligibility for a beta test. A Product Manager needs to know if all users who signed up last month are in the 'Beta Tester' segment before rolling out new code. They ask their agent to list the members of that specific segment using `list_segment_members`, getting an immediate, accurate count and list. ### An API endpoint changed, requiring mass notifications. A developer needs to notify every user about a mandatory password reset. Instead of writing complex SQL or logging into the portal, they ask their agent to run `send_transactional_email` for all users, ensuring everyone gets the required message. ### Analyzing poor campaign performance after a product update. A Growth Marketer notices that the 'Welcome Sequence' is underperforming. They ask their agent to run `get_campaign_performance` for that flow, immediately seeing that the click-through rate dropped by 15%. ### Auditing user data before a sales call. A Product Manager wants full context on a single high-value client. They prompt their agent to `get_customer_details` for that person, instantly reviewing all their profile attributes and interaction history. ## Benefits - Get instant user intelligence: Use `get_customer_details` to pull detailed attributes for any profile, letting you verify exactly what data points a user has without manual database queries. - Measure campaign success immediately: Check how well automated flows performed by calling `get_campaign_performance`, giving you open rates and click metrics right in your chat window. - Target the right people at scale: You can list specific groups using `list_audience_segments` or narrow it down to active users with `list_segment_members`, ensuring your messages hit the intended audience. - Handle one-off needs reliably: For critical communication, use `send_transactional_email` to dispatch a single, personalized email—like confirming an account change—without running a full campaign. - Run manual bursts of activity: Need to send a quick announcement? Use `dispatch_broadcast` to trigger a message across your entire user base immediately. - Maintain connectivity health: Quickly check if everything's working by calling `get_connection_status`, which verifies the API link between your AI and Customer.io. ## How It Works The bottom line is: Your AI agent translates complex marketing queries into simple requests that access and process your live customer database. 1. Subscribe to this MCP in Vinkius. 2. Retrieve your App API Key from Customer.io and identify your target region (US or EU). 3. Start asking your AI client questions about customer segments, campaign results, or user data. ## Frequently Asked Questions **How do I check campaign performance using Customer.io MCP?** You call `get_campaign_performance`. This tool pulls metrics like open rates and click counts for specific automated campaigns so you know exactly how well your marketing is working. **Can I find out how many people are in a segment using Customer.io MCP?** Yes, use `list_audience_segments` to view the directory of segments available. Then, you can request the member count for any specific group. **How do I send an email manually with Customer.io MCP?** You can use `dispatch_broadcast` if you want to message everyone, or use `send_transactional_email` if the communication is one-to-one for a specific person. **What is the difference between listing users and getting customer details with Customer.io MCP?** Listing users (`list_customers`) gives you a general list of people. Getting customer details (`get_customer_details`) drills down to give you all the specific attributes and traits for one person. **How do I check my API health using the get_connection_status tool?** It instantly confirms if your credentials are valid and if Vinkius can reach Customer.io. This non-destructive call verifies endpoint connectivity before you run any complex data queries. **What metadata do I receive when listing segments using list_audience_segments?** The tool returns the segment's full name, its defining criteria, and the current member count. This lets you validate that a segment was built correctly before marketing actions. **How can I audit planned messages using list_scheduled_broadcasts?** It pulls a record of all one-to-many messages set to send at a future date. This is key for checking scheduled workflows and ensuring timely communication deployments. **Where do I find my reusable content options with list_newsletters?** This tool lists every saved newsletter and broadcast template in your account. It lets you review available message content before manually sending emails or building a new campaign. **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.