Skip to content
MCP server

Customer.io MCP by usefulapi

Query people, segments, campaigns, and message deliveries; send transactional email or…

Install
Runs
Remotely
Version
1.40.0
Listing updated
5 days ago

About Customer.io MCP by usefulapi

Customer.io MCP by usefulapi is an MCP server. It runs as a hosted remote server, so there is nothing to install locally.

Query people, segments, campaigns, and message deliveries; send transactional email or broadcasts.

Install

Run in a terminal

claude mcp add --transport http customerio https://customerio.usefulapi.io/mcp

Add to Settings → Connectors → Add custom connector

https://customerio.usefulapi.io/mcp
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "customerio": {
      "url": "https://customerio.usefulapi.io/mcp"
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "customerio": {
      "type": "http",
      "url": "https://customerio.usefulapi.io/mcp"
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "customerio": {
      "serverUrl": "https://customerio.usefulapi.io/mcp"
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "customerio": {
      "type": "http",
      "url": "https://customerio.usefulapi.io/mcp"
    }
  }
}

Tools this server provides (13)

Read directly from the server.

customerio_search_customers
Search/list people by a Customer.io filter (segment or attribute conditions). e.g. filter={"segment":{"id":7}} or {"and":[...]}. App API: POST /v1/customers.
customerio_get_customer_attributes
Get a single person's attributes (profile fields). App API: GET /v1/customers/{customer_id}/attributes.
customerio_get_customer_segments
List the segments a single person belongs to. App API: GET /v1/customers/{customer_id}/segments.
customerio_get_customer_messages
List messages (deliveries) sent to a single person. App API: GET /v1/customers/{customer_id}/messages.
customerio_list_segments
List all segments in the workspace (id + name + type). App API: GET /v1/segments.
customerio_list_campaigns
List all campaigns in the workspace. App API: GET /v1/campaigns.
customerio_get_campaign
Get a single campaign by id. App API: GET /v1/campaigns/{campaign_id}.
customerio_get_campaign_metrics
Get delivery/engagement metrics for a campaign over time. App API: GET /v1/campaigns/{campaign_id}/metrics.
customerio_list_messages
List sent messages (deliveries) across the workspace, filterable by type/campaign/newsletter. App API: GET /v1/messages.
customerio_list_exports
List data exports in the workspace. App API: GET /v1/exports.
customerio_list_collections
List reusable data collections in the workspace. App API: GET /v1/collections.
customerio_send_transactional_email
⚠️ SENDS A REAL EMAIL. Send a transactional email using a transactional message template. Delivers immediately to the `to` recipient. App API: POST /v1/send/email.
customerio_trigger_broadcast
⚠️ SENDS TO REAL RECIPIENTS. Trigger an API-triggered broadcast, delivering to the resolved recipient set. App API: POST /v1/send/broadcast (posts to /v1/campaigns/{broadcast_id}/triggers).

Customer.io MCP by usefulapi FAQ

How do I add Customer.io MCP by usefulapi to Claude Code?

Run this command in your terminal: claude mcp add --transport http customerio https://customerio.usefulapi.io/mcp