# Customer.io MCP > Customer.io MCP connects your AI agent directly to sophisticated marketing automation and customer data. Use this MCP to manage user profiles, track every event they perform on your site, and send immediate, targeted messages—like emails or push notifications—based on real-time behavior. ## Overview - **Category:** marketing-automation - **Price:** Free - **Tags:** customer-engagement, transactional-email, event-tracking, marketing-campaigns, user-segmentation ## Description This MCP lets you orchestrate complex marketing and communication workflows using only natural language commands. Instead of logging into a dashboard, building segments, and clicking through multiple tabs, you tell your agent what needs to happen. Your agent then handles the connection, whether that’s updating a user's status, recording a specific page view, or sending an urgent push notification. It covers the whole customer lifecycle: from tracking initial interest (like calling `pipeline_page`) all the way through highly personalized transactional messaging (`send_transactional_email`). If you're building your agent workflow on Vinkius, this MCP gives you access to a complete set of tools that manage profiles, track behaviors for both identified and anonymous users, and trigger everything from newsletters to in-app alerts. You can reliably update customer records using `add_or_update_customer` or even merge duplicate accounts with `merge_customers`, all without writing a single line of code. ## Tools ### add_or_update_customer Creates a new user profile in the system or updates specific details for an existing person. ### delete_customer Permanently removes a customer's record from the platform. ### merge_customers Combines two separate user profiles into a single, unified account record. ### pipeline_batch Sends multiple data updates—like tracking pages and people—in one efficient request. ### pipeline_group Associates users with related entities, such as linking a person to a company profile object. ### pipeline_identify Identifies a user in the system and assigns specific traits or properties to their profile record. ### pipeline_page Records that a user has viewed a specific page on your website for tracking purposes. ### pipeline_screen Logs when a mobile user views an entire screen or view within the application. ### pipeline_track Records specific, custom actions users take on your site, like clicking a button or submitting a form. ### send_newsletter Immediately sends out an email newsletter to all subscribed recipients. ### send_transactional_email Sends a high-priority, templated email for specific events, like password resets or receipts. ### send_transactional_in_app Delivers a direct message to the user inside your application interface. ### send_transactional_push Sends an urgent notification directly to the user's mobile device or operating system. ### track_anonymous_event Records events and actions for users who are not logged in, helping you understand initial site behavior. ### track_batch Sends multiple types of entity operations (people or objects) in a single, optimized request. ### track_customer_event Tracks an event and links it directly to a specific customer profile. ### track_entity Performs general actions, like creating or deleting any single person or object record. ### trigger_broadcast Initiates a large-scale, immediate broadcast message to all connected users. ## Prompt Examples **Prompt:** ``` Update customer 'user_123' and set their 'loyalty_tier' to 'gold'. ``` **Response:** ``` I've updated the profile for 'user_123'. Their 'loyalty_tier' is now set to 'gold' in Customer.io. ``` **Prompt:** ``` Track a 'completed_tutorial' event for customer 'jane@example.com'. ``` **Response:** ``` The 'completed_tutorial' event has been successfully recorded for jane@example.com. ``` **Prompt:** ``` Send a transactional email using template ID 'welcome_msg' to 'new_user@test.com'. ``` **Response:** ``` I've triggered the transactional email 'welcome_msg' for new_user@test.com via the App API. ``` ## Capabilities ### Update Customer Profiles Create new user identities, modify existing attributes, or combine multiple profiles into one accurate record. ### Track User Behavior and Events Record custom actions—like completing a tutorial or viewing specific screens—for both logged-in and unknown users to build behavioral data points. ### Send Targeted Campaigns Trigger mass broadcasts, send scheduled newsletters, or target specific user groups with high-priority alerts. ### Manage Communications Channels Dispatch immediate transactional messages through email, mobile push notifications, and in-app popups using custom payloads. ## Use Cases ### A user signs up but never completes onboarding. The agent detects a sign-up event. It immediately calls `track_anonymous_event` to log the initial activity, then uses `pipeline_identify` when the user logs in later. Finally, it sends a targeted email using `send_transactional_email` with a specific 'welcome' template that guides them back into the app. ### An Ops team member needs to fix duplicate customer records. The agent is prompted: 'Merge user A and user B.' It invokes `merge_customers`, consolidating all purchase histories, event logs, and contact data onto one clean profile. This prevents fragmented data reporting. ### A new product feature launches and needs tracking. The agent is told to monitor the feature adoption. It uses `pipeline_track` whenever a user interacts with the new component, allowing Product Managers to build real-time usage reports without installing custom trackers. ### A critical service alert needs immediate distribution. The agent is instructed: 'Send an urgent system update to all active users.' It triggers a `trigger_broadcast` and supplements this by sending a dedicated push notification using `send_transactional_push`, ensuring the message reaches them instantly across devices. ## Benefits - Build comprehensive user views instantly. Instead of manually checking multiple dashboards to see what a user has done, you can trigger `pipeline_identify` or use the `track_customer_event` tool to build a single record detailing their entire history. - Handle all communications channels from one place. Whether it's a standard newsletter via `send_newsletter`, a critical receipt using `send_transactional_email`, or an urgent push alert, your agent manages the payload and delivery. - Maintain clean data by automating profile management. If a user changes their name or role, calling `add_or_update_customer` keeps the record current without manual intervention. - Understand anonymous traffic flow. You can use `track_anonymous_event` to gather data on visitors who haven't logged in yet, providing context before they even create an account. - Manage complex relationships efficiently. Tools like `pipeline_group` allow you to associate people with corporate objects or other entities, mapping out the full organizational structure automatically. ## How It Works The bottom line is you get to manage every stage of your customer journey by talking directly to your AI client, bypassing manual platform steps entirely. 1. First, you subscribe to this MCP on Vinkius and supply the required Customer.io Site ID, API Key, and App API Key. 2. Next, your AI agent uses natural language prompts—like 'Track a sign-up event for user X'—to invoke specific tools within the system. 3. Finally, the MCP executes the command, updating profiles or sending messages instantly through Customer.io’s infrastructure. ## Frequently Asked Questions **How do I use Customer.io MCP to track user behavior?** You can record various behaviors by calling specific tools. Use `pipeline_page` when a user views a page, or `pipeline_track` for custom actions like clicking a button. **Can I use Customer.io MCP to send emails?** Yes, you can dispatch transactional messages using `send_transactional_email`, which is ideal for receipts and password resets. You can also trigger marketing newsletters with `send_newsletter`. **What if I need to combine two users' data?** Use the `merge_customers` tool. This function consolidates profiles, ensuring that all event history and attributes from both accounts are combined into a single, clean identity. **Is Customer.io MCP limited to logged-in users?** No. You can track initial interest using `track_anonymous_event` for visitors who haven't created an account yet. This helps you understand early site activity. **How do I ensure my marketing message is immediate?** For urgency, use the tools designed for real-time alerts like `send_transactional_push` or `trigger_broadcast`. These methods bypass slower, scheduled sends.