Customer.io
Customer.io is a customer engagement platform that enables businesses to send targeted messages to their customers through various channels, including email, SMS, and push notifications.
Verdict
Common use cases
- Pull delivery stats for recent email campaigns
- Audit segment membership before launching broadcast
- Troubleshoot webhook failures during incident response
- Review trigger history for automated workflows
- Export message metrics for weekly performance reports
Integration
- Vendor
- Customer.io
- Category
- other
- Auth
- API_KEY
- Tools
- 14
- Composio slug
customerio
Tools
- Get Customer.io Workspace Webhooks
Tool to retrieve a list of webhooks. use after setting up reporting webhooks to fetch current webhook configurations in your workspace.
- Get Integrations
Tool to retrieve a list of integrations in your workspace. use when you need to discover configured integrations.
- Get Messages
Tool to retrieve a list of messages sent from your workspace. use when you need paginated delivery metrics for messages, e.g., list email messages delivered between two timestamps.
- Get Segment Details
Tool to retrieve details of a specific segment. use after identifying the segment id from list segments.
- Get Segment Membership
Tool to retrieve people in a specific segment. use when you need to page through segment membership after identifying segment id.
- Get Segments
Tool to retrieve a list of segments in your workspace. use when you need to fetch all segments after configuring segment rules.
- Get Trigger
Tool to retrieve details about a specific trigger. use after triggering a broadcast to confirm its status and metadata.
- Get Triggers
Tool to retrieve a list of triggers for a specific broadcast. use after identifying broadcast id to inspect associated triggers.
- List Collections
Tool to list all collections metadata. use when you need to retrieve current details of each collection in your workspace.
- List Newsletters
Tool to list all newsletters. use when paginating through newsletter metadata.
- List Snippets
Tool to list all snippets in your workspace. use when you need to retrieve all reusable content snippets for templating or dynamic content insertion.
- List Transactional Messages
Tool to list all transactional message templates. use when you need to fetch available transactional messages.
- Suppress Customer Profile
Tool to suppress a person. use when you need to permanently delete a customer's profile and prevent them from being re-added.
- Trigger Broadcast
Tool to manually trigger a broadcast. use when you need to override the default audience and provide personalization data after confirming the broadcast id.
Setup
Setup guide
- 11. In Switchy, open your workspace settings and navigate to the Integrations tab. 2. Click 'Add Integration' and select Customer.io from the list. 3. In a separate tab, log into your Customer.io account and go to Settings > API Credentials. 4. Generate a new Tracking API key or copy an existing one with read permissions for messages, segments, and webhooks. 5. Paste the API key into Switchy's connection form and click 'Connect'. 6. Switchy will verify the key by fetching your workspace metadata. 7. Once connected, open any Space and type '@Customer.io list segments' to test — you should see a list of your audience segments appear in the response. 8. If the test fails, double-check the API key has the correct scopes and hasn't expired in Customer.io's dashboard.
What teammates see: by default, memories from Customer.io are scoped to the Space (PROJECT visibility) - you can mark any memory PRIVATE or share it ORG-wide.
Works well with
Top models
Compatibility data appears once enough Spaces have used this MCP together with a given model.
How Switchy teams use it
Starter prompts
Campaign Delivery Report
@Customer.io get messages delivered in the last 7 days and summarize open rates, click rates, and any delivery failures by message typeOpen in a Space →
Segment Membership Check
@Customer.io show me the first 50 people in the 'Trial Users - Day 3' segment and include their signup date and last activity timestampOpen in a Space →
Webhook Configuration Audit
@Customer.io list all webhooks in this workspace and flag any that are disabled or pointing to staging URLsOpen in a Space →
Broadcast Trigger History
@Customer.io get triggers for broadcast ID 12345 and show me which segments were targeted and when each trigger firedOpen in a Space →
Integration Health Check
@Customer.io retrieve all integrations in this workspace and highlight any that are disconnected or showing sync errorsOpen in a Space →
Example outputs
Illustrative - representative of the model's voice and quality, not literal recordings.
@customer.io show me all segments in our workspace and how many people are in each one
Here are the segments currently configured in your Customer.io workspace: 'Active Trial Users' (1,247 members), 'Churned Last 30 Days' (89 members), 'High-Value Customers' (412 members), 'Onboarding Incomplete' (2,103 members), and 'Power Users' (156 members). Each segment reflects real-time membership based on your configured rules. This example illustrates the kind of overview you'd receive — actual segment names and counts will match your workspace configuration.
This example demonstrates read-only segment discovery. Requires API key with read access to segments. Membership counts are current at query time but may change as customer attributes update. Use this to audit segmentation strategy or identify which audiences are available for targeting in campaigns.
@customer.io what email messages did we send yesterday and what were the delivery rates
Yesterday your workspace sent 4 email messages: 'Weekly Product Update' (delivered to 8,421 of 8,500 recipients, 98.1% delivery rate), 'Cart Abandonment Reminder' (delivered to 1,203 of 1,250, 96.2%), 'Trial Ending Soon' (delivered to 445 of 450, 98.9%), and 'Welcome Series - Day 3' (delivered to 2,987 of 3,100, 96.4%). This example shows how the MCP surfaces message-level metrics — your actual results will include bounce reasons and engagement data for the specific time range you query.
This example uses the Get Messages tool with timestamp filtering. Requires API key with read access to message metrics. Results are paginated for workspaces with high message volume. Delivery rates shown here are illustrative — real queries return detailed bounce and engagement breakdowns you can analyze for deliverability issues.
@customer.io find everyone in the 'Churned Last 30 Days' segment and summarize common attributes that might explain why they left
The 'Churned Last 30 Days' segment contains 89 people. After retrieving their profiles, common patterns emerge: 67% had fewer than 3 logins in their final month, 54% never completed the onboarding checklist, 41% were on the free tier without upgrading, and 28% had support tickets that went unresolved for over 5 days. This example illustrates how the MCP can fetch segment membership and let the AI identify trends — your actual analysis will depend on which customer attributes you track in Customer.io.
This example chains Get Segments, Get Segment Details, and Get Segment Membership, then applies AI reasoning to the returned customer data. Requires API key with read access to people and segments. Segment membership queries are paginated, so large segments may take multiple requests. The AI's pattern analysis is only as good as the attributes you've instrumented in Customer.io.
Use-case deep-dives
When this MCP wins for campaign post-mortems
A 3-person growth team runs weekly email campaigns and needs to pull delivery stats into Slack for Friday retros. The Get Messages tool filters by timestamp and returns paginated metrics—open rates, bounces, deliveries—without logging into Customer.io's dashboard. This MCP is the right call if your team sends fewer than 10 campaigns a week and you're already using Switchy for cross-tool reporting. The API_KEY auth means anyone on the team can query last week's sends in under 30 seconds. If you're running 50+ campaigns a month or need real-time alerting, you'll hit rate limits and want a dedicated BI tool instead. For small teams doing weekly campaign reviews, this MCP turns a 10-minute dashboard hunt into a one-prompt pull.
When segment membership queries beat manual exports
A 5-person support team at a B2B SaaS company needs to verify which customers are in a 'churned-last-quarter' segment before sending a win-back offer. The Get Segment Membership tool pages through the list and surfaces email addresses without exporting a CSV or opening the Customer.io UI. This MCP works if you're auditing fewer than 20 segments a month and your compliance process lives in Switchy alongside Zendesk and Notion. The 14 tools cover segments, triggers, and webhooks, so you can cross-check who got what message. If your segments have 100k+ members or you need real-time sync to a CRM, the pagination will slow you down and you'll want a direct database connection. For quarterly audits or one-off segment checks, this MCP cuts the export-download-upload loop to zero.
When webhook and integration discovery saves debug time
A 2-person ops team at a startup troubleshoots why Stripe purchase events aren't triggering Customer.io campaigns. The Get Integrations and Get Workspace Webhooks tools list every configured integration and webhook endpoint in one query, surfacing stale URLs or missing API keys. This MCP is the right call if you manage fewer than 10 integrations and your debugging workflow already happens in Switchy with logs from Sentry and Datadog. The API_KEY auth means you don't need OAuth for a one-off health check. If you're managing 30+ integrations or need automated monitoring, you'll want a dedicated observability stack instead of manual queries. For small teams doing monthly integration audits or incident triage, this MCP turns a 20-minute UI hunt into a 2-minute prompt.
Frequently asked
What does the Customer.io MCP let Switchy do?
It pulls delivery metrics, segment membership, and webhook configs from your Customer.io workspace. You can query which messages went out, who's in a segment, and what integrations are active—without leaving Switchy. The MCP reads data; it doesn't send campaigns or update customer profiles.
Do I need admin access to connect Customer.io?
You need a Customer.io API key with read permissions for messages, segments, webhooks, and integrations. Admin access isn't strictly required, but most workspaces restrict API key creation to admins. Check your workspace settings under API Credentials to confirm your role can generate keys.
Can the Customer.io MCP trigger campaigns or update customer attributes?
No. The MCP is read-only. It retrieves broadcast triggers, segment details, and delivery logs, but it can't send messages, modify customer data, or change campaign settings. If you need write access, use Customer.io's Track API directly or build a custom integration.
Why use this MCP instead of logging into Customer.io?
When you're already in Switchy analyzing user behavior or support tickets, the MCP surfaces delivery data inline—no tab-switching. It's faster for ad-hoc queries like "show me everyone in the trial-expiring segment" or "which emails bounced yesterday". For campaign design, you still need the Customer.io UI.
Who on the team should connect the Customer.io MCP?
Whoever owns customer lifecycle analytics or support ops. Marketing ops teams use it to audit segment membership; support leads use it to check if a customer received a specific email. The API key holder is responsible for the connection, so assign it to someone who already manages Customer.io integrations.