Track customer events, manage profiles and segments, trigger campaigns and broadcasts with Customer.io.
Use with AI AssistantsMCP
Connect Claude, Cursor, or any MCP-compatible client — then call tools directly
① Add This MCP Server
Paste into your AI client config — then all its tools are available instantly.
{
"mcpServers": {
"customer-io": {
"url": "https://mcp.aerostack.dev/s/aerostack/mcp-customer-io",
"headers": {
"Authorization": "Bearer YOUR_AEROSTACK_TOKEN"
}
}
}
}Replace YOUR_AEROSTACK_TOKEN with your API token from the dashboard.
② Call a Tool
Ask your AI assistant to call a specific tool, or send raw JSON-RPC:
Natural Language Prompt
“Use the identify_customer tool to create or update (upsert) a customer profile by id. safe to call repeatedly — will update attributes without creating duplicates”
Using a Workspace?
Add this MCP to your Workspace — your team shares one token, secrets are stored securely, and every AI agent in the workspace can call it without per-user setup.
Track customer events, manage profiles, trigger campaigns and broadcasts via Customer.io — behavioral messaging automation for your AI agents.
Customer.io is a behavior-based messaging platform that lets you send targeted emails, push notifications, and SMS based on what people actually do. This MCP server gives your agents complete access: identify and update customer profiles, track events that trigger automations, manage segments, inspect campaigns, send transactional broadcasts, and retrieve delivery metrics.
Live endpoint: https://mcp.aerostack.dev/s/aerostack/mcp-customer-io
| Tool | Description |
|---|---|
| Customers | |
| identify_customer | Create or update a customer profile (upsert by ID) |
| get_customer | Get a customer profile by ID from the App API |
| update_customer | Update attributes on an existing customer |
| delete_customer | Permanently delete a customer and all their data |
| list_customers | Search for customers using filter parameters |
| Events | |
| track_event | Track a named event for a specific customer |
| track_anonymous_event | Track an event for an anonymous visitor |
| batch_track | Send multiple identify/track operations in one request |
| get_customer_activities | Get activity history for a customer |
| Segments | |
| list_segments | List all segments in the workspace |
| get_segment | Get segment details including customer count |
| add_to_segment | Add customers to a manual segment |
| remove_from_segment | Remove customers from a manual segment |
| Campaigns | |
| list_campaigns | List all campaigns in the workspace |
| get_campaign | Get full campaign details including actions |
| list_broadcasts | List all transactional broadcasts |
| trigger_broadcast | Trigger a transactional broadcast to a customer |
| Messages | |
| get_campaign_metrics | Get delivery and engagement metrics for a campaign |
| list_messages | List messages sent to a specific customer |
| list_webhooks | List all reporting webhooks |
| Variable | Required | Description | How to Get |
|---|---|---|---|
| CUSTOMER_IO_SITE_ID | Yes | Your Customer.io Site ID (used for Track API basic auth) | Settings → API Credentials |
| CUSTOMER_IO_API_KEY | Yes | Your Customer.io API Key (used for both Track and App APIs) | Settings → API Credentials |
CUSTOMER_IO_SITE_ID and CUSTOMER_IO_API_KEY under Project → SecretsOnce configured, every AI agent in your workspace can track events, manage customer data, and trigger campaigns automatically.
"Identify user 'user-12345' in Customer.io with email alice@example.com and plan=pro"
"Track a 'subscription_cancelled' event for customer user-12345 with reason='price'"
"Add customers user-001, user-002, user-003 to manual segment ID 5"
"Trigger broadcast ID 20 to send a password reset to alice@example.com"
"Get campaign metrics for campaign 10 grouped by weeks"
curl -X POST https://mcp.aerostack.dev/s/aerostack/mcp-customer-io \
-H 'Content-Type: application/json' \
-H 'X-Mcp-Secret-CUSTOMER-IO-SITE-ID: your-site-id' \
-H 'X-Mcp-Secret-CUSTOMER-IO-API-KEY: your-api-key' \
-d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"track_event","arguments":{"customer_id":"user-001","name":"purchased","data":{"plan":"pro","amount":49}}}}'
curl -X POST https://mcp.aerostack.dev/s/aerostack/mcp-customer-io \
-H 'Content-Type: application/json' \
-d '{"jsonrpc":"2.0","id":1,"method":"initialize"}'
Customer.io uses two separate APIs with different auth schemes:
| API | Base URL | Auth Method |
|---|---|---|
| Track API | https://track.customer.io/api/v1 | Basic auth: base64(SITE_ID:API_KEY) |
| App API | https://api.customer.io/v1 | Bearer token: Authorization: Bearer API_KEY |
Write operations (identify, track events, delete) use the Track API. Read operations (list customers, segments, campaigns, metrics) use the App API. The worker handles this routing automatically — you only need to provide both secrets once.
identify_customer is an upsert — calling it repeatedly with the same id updates the profile without creating duplicatesbatch_track uses the v2 batch endpoint (/api/v2/batch) which supports up to 1,000 operations per calltrigger_broadcast accepts either to.id (customer ID) or to.email — use whichever identifier you haveadd_to_segment / remove_from_segment only works on manual segments; dynamic segments are computed automaticallyget_customer_activities is paginated — use the next cursor from the response to fetch moreLive Endpoint
https://mcp.aerostack.dev/s/aerostack/mcp-customer-io
Sub-50ms globally · Zero cold start
@aerostack
Pre-built functions for the most common MCP tool patterns. Clone, extend, and deploy.
by @aerostack
Discover and invoke any MCP, Function, or Skill published to the Aerostack marketplace — the universal AI capability hub.
by @aerostack
Search indexes, manage records, browse data, and configure ranking in Algolia — AI-native instant search access.
by @aerostack
Query documents, run AQL, traverse graphs, and manage collections in your ArangoDB database — AI-native multi-model database access.
by @aerostack
Post, schedule, and analyze social media across 13 platforms — Facebook, Instagram, X, LinkedIn, TikTok, Bluesky, Threads, Reddit, Pinterest, YouTube, Telegram, Snapchat, Google Business.
by @aerostack
Manage projects, to-dos, messages, schedules, and campfire chats in Basecamp — AI-native project management.
by @aerostack
Run SQL queries, list datasets and tables, inspect schemas, and export results from Google BigQuery — AI-native data warehouse access.
Yes. The Customer Io MCP includes a create_segment tool that lets Claude create segments in your Customer Io account from a plain-English prompt. You can also update and delete segments — no Customer Io UI needed.
Yes. The Customer Io MCP includes tools to list and retrieve customers from your Customer Io account. Claude can filter, sort, and summarize customers based on your instructions.
Yes. The Customer Io MCP uses the open Model Context Protocol standard, so it works in Claude, Cursor, Windsurf, and any other MCP-compatible AI tool. All 20 Customer Io tools are available everywhere you connect it — install once on Aerostack.
Yes. The Customer Io MCP includes tools to update customers in your Customer Io account. Tell Claude what to change in plain English — it reads the current state and applies the update via the Customer Io API.