Customer.io MCP by usefulapi is an MCP server published by io.usefulapi, hosted at customerio.usefulapi.io. When last checked on 2026-11-21 it was working: it answers and lists its tools. It declares 13 tools, including customerio_search_customers, customerio_get_customer_attributes, customerio_get_customer_segments, customerio_get_customer_messages, customerio_list_segments.
Query people, segments, campaigns, and message deliveries; send transactional email or broadcasts.
4,305 connections through 5 shared values. Tap any node.
Squares are this server's values; dots are other servers sharing them. A shared address or publisher is a lead, not proof of a common operator.
Inferred from the host name and headers: what a server runs on, not who runs it.
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.
| Parameter | Type | Description |
|---|---|---|
| limit | integer | Max people to return. |
| start | string | Pagination cursor from a previous response's `next`. |
| filter * | object | Customer.io filter object, e.g. {"segment":{"id":7}} or {"and":[{"attribute":{"field":"email","operator":"exists"}}]}. |
{
"name": "customerio_search_customers",
"title": "Search customers",
"description": "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.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"filter"
],
"properties": {
"limit": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Max people to return.",
"exclusiveMinimum": 0
},
"start": {
"type": "string",
"description": "Pagination cursor from a previous response's `next`."
},
"filter": {
"type": "object",
"description": "Customer.io filter object, e.g. {\"segment\":{\"id\":7}} or {\"and\":[{\"attribute\":{\"field\":\"email\",\"operator\":\"exists\"}}]}.",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
}
}
},
"annotations": {
"title": "Search customers",
"readOnlyHint": true
}
}Get a single person's attributes (profile fields). App API: GET /v1/customers/{customer_id}/attributes.
| Parameter | Type | Description |
|---|---|---|
| customer_id * | string | The person's id (or cio_id / email, per your identifier setup). |
{
"name": "customerio_get_customer_attributes",
"title": "Get customer attributes",
"description": "Get a single person's attributes (profile fields). App API: GET /v1/customers/{customer_id}/attributes.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"customer_id"
],
"properties": {
"customer_id": {
"type": "string",
"description": "The person's id (or cio_id / email, per your identifier setup)."
}
}
},
"annotations": {
"title": "Get customer attributes",
"readOnlyHint": true
}
}List the segments a single person belongs to. App API: GET /v1/customers/{customer_id}/segments.
| Parameter | Type | Description |
|---|---|---|
| customer_id * | string | The person's id. |
{
"name": "customerio_get_customer_segments",
"title": "Get customer segments",
"description": "List the segments a single person belongs to. App API: GET /v1/customers/{customer_id}/segments.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"customer_id"
],
"properties": {
"customer_id": {
"type": "string",
"description": "The person's id."
}
}
},
"annotations": {
"title": "Get customer segments",
"readOnlyHint": true
}
}List messages (deliveries) sent to a single person. App API: GET /v1/customers/{customer_id}/messages.
| Parameter | Type | Description |
|---|---|---|
| limit | integer | Max messages to return. |
| start | string | Pagination cursor from a previous response's `next`. |
| customer_id * | string | The person's id. |
{
"name": "customerio_get_customer_messages",
"title": "Get customer messages",
"description": "List messages (deliveries) sent to a single person. App API: GET /v1/customers/{customer_id}/messages.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"customer_id"
],
"properties": {
"limit": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Max messages to return.",
"exclusiveMinimum": 0
},
"start": {
"type": "string",
"description": "Pagination cursor from a previous response's `next`."
},
"customer_id": {
"type": "string",
"description": "The person's id."
}
}
},
"annotations": {
"title": "Get customer messages",
"readOnlyHint": true
}
}List all segments in the workspace (id + name + type). App API: GET /v1/segments.
No parameters.
{
"name": "customerio_list_segments",
"title": "List segments",
"description": "List all segments in the workspace (id + name + type). App API: GET /v1/segments.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {}
},
"annotations": {
"title": "List segments",
"readOnlyHint": true
}
}List all campaigns in the workspace. App API: GET /v1/campaigns.
No parameters.
{
"name": "customerio_list_campaigns",
"title": "List campaigns",
"description": "List all campaigns in the workspace. App API: GET /v1/campaigns.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {}
},
"annotations": {
"title": "List campaigns",
"readOnlyHint": true
}
}Get a single campaign by id. App API: GET /v1/campaigns/{campaign_id}.
| Parameter | Type | Description |
|---|---|---|
| campaign_id * | ["string","number"] | Campaign id. |
{
"name": "customerio_get_campaign",
"title": "Get campaign",
"description": "Get a single campaign by id. App API: GET /v1/campaigns/{campaign_id}.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"campaign_id"
],
"properties": {
"campaign_id": {
"type": [
"string",
"number"
],
"description": "Campaign id."
}
}
},
"annotations": {
"title": "Get campaign",
"readOnlyHint": true
}
}Get delivery/engagement metrics for a campaign over time. App API: GET /v1/campaigns/{campaign_id}/metrics.
| Parameter | Type | Description |
|---|---|---|
| type | string | Metric type filter (e.g. email, push, sms). |
| steps | integer | Number of periods to return. |
| period | string | Bucket size. Default days. |
| campaign_id * | ["string","number"] | Campaign id. |
{
"name": "customerio_get_campaign_metrics",
"title": "Get campaign metrics",
"description": "Get delivery/engagement metrics for a campaign over time. App API: GET /v1/campaigns/{campaign_id}/metrics.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"campaign_id"
],
"properties": {
"type": {
"type": "string",
"description": "Metric type filter (e.g. email, push, sms)."
},
"steps": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Number of periods to return.",
"exclusiveMinimum": 0
},
"period": {
"enum": [
"hours",
"days",
"weeks",
"months"
],
"type": "string",
"description": "Bucket size. Default days."
},
"campaign_id": {
"type": [
"string",
"number"
],
"description": "Campaign id."
}
}
},
"annotations": {
"title": "Get campaign metrics",
"readOnlyHint": true
}
}List sent messages (deliveries) across the workspace, filterable by type/campaign/newsletter. App API: GET /v1/messages.
| Parameter | Type | Description |
|---|---|---|
| type | string | Message type filter, e.g. email | push | sms | in_app | webhook | slack | twilio. |
| limit | integer | Max messages to return. |
| start | string | Pagination cursor from a previous response's `next`. |
| drafts | boolean | Include drafts. |
| campaign_id | ["string","number"] | Filter to a specific campaign. |
| newsletter_id | ["string","number"] | Filter to a specific newsletter. |
{
"name": "customerio_list_messages",
"title": "List messages",
"description": "List sent messages (deliveries) across the workspace, filterable by type/campaign/newsletter. App API: GET /v1/messages.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"type": {
"type": "string",
"description": "Message type filter, e.g. email | push | sms | in_app | webhook | slack | twilio."
},
"limit": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Max messages to return.",
"exclusiveMinimum": 0
},
"start": {
"type": "string",
"description": "Pagination cursor from a previous response's `next`."
},
"drafts": {
"type": "boolean",
"description": "Include drafts."
},
"campaign_id": {
"type": [
"string",
"number"
],
"description": "Filter to a specific campaign."
},
"newsletter_id": {
"type": [
"string",
"number"
],
"description": "Filter to a specific newsletter."
}
}
},
"annotations": {
"title": "List messages",
"readOnlyHint": true
}
}List data exports in the workspace. App API: GET /v1/exports.
No parameters.
{
"name": "customerio_list_exports",
"title": "List exports",
"description": "List data exports in the workspace. App API: GET /v1/exports.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {}
},
"annotations": {
"title": "List exports",
"readOnlyHint": true
}
}List reusable data collections in the workspace. App API: GET /v1/collections.
No parameters.
{
"name": "customerio_list_collections",
"title": "List collections",
"description": "List reusable data collections in the workspace. App API: GET /v1/collections.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {}
},
"annotations": {
"title": "List collections",
"readOnlyHint": true
}
}⚠️ 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.
| Parameter | Type | Description |
|---|---|---|
| to * | string | Recipient email address. |
| body | string | Override the email body. |
| from | string | Override the sender address. |
| subject | string | Override the subject line. |
| identifiers * | object | Person identifiers, e.g. {"id":"..."} or {"email":"..."}. |
| message_data | object | Template variables (liquid) to interpolate into the message. |
| send_to_unsubscribed | boolean | If true, send even to unsubscribed recipients. |
| transactional_message_id * | ["string","number"] | The transactional message template id (or trigger name). |
| disable_message_retention | boolean | If true, don't retain the message body. |
⚠️ 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).
| Parameter | Type | Description |
|---|---|---|
| data | object | Liquid variables available to the broadcast templates. |
| recipients | object | Recipient filter object (overrides the broadcast's configured audience). |
| broadcast_id * | ["string","number"] | The API-triggered broadcast id. |
| id_ignore_missing | boolean | Skip recipients missing an id instead of erroring. |
| email_add_duplicates | boolean | Allow duplicate email recipients. |
| email_ignore_missing | boolean | Skip recipients missing an email instead of erroring. |
{
"name": "customerio_trigger_broadcast",
"title": "Trigger broadcast",
"description": "⚠️ 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).",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"broadcast_id"
],
"properties": {
"data": {
"type": "object",
"description": "Liquid variables available to the broadcast templates.",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"recipients": {
"type": "object",
"description": "Recipient filter object (overrides the broadcast's configured audience).",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"broadcast_id": {
"type": [
"string",
"number"
],
"description": "The API-triggered broadcast id."
},
"id_ignore_missing": {
"type": "boolean",
"description": "Skip recipients missing an id instead of erroring."
},
"email_add_duplicates": {
"type": "boolean",
"description": "Allow duplicate email recipients."
},
"email_ignore_missing": {
"type": "boolean",
"description": "Skip recipients missing an email instead of erroring."
}
}
},
"annotations": {
"title": "Trigger broadcast",
"destructiveHint": true
}
}Tools for Customer.io, hosted by usefulapi.io. If the user is new or asks what this server can do, suggest requests such as: "How did my last campaign perform for opens and clicks?"; "List all my customer segments and what each is called."; "Which messages did we send to jane@example.com recently?". Read-only tools never change data; ask the user before a tool that creates, changes or deletes Customer.io data. Free plan: 50 tool calls per month. Run customerio_usage_status to see the calls used this month. If the user asks for something none of these tools can do, tell the user and, with their OK, run customerio_request_feature to record the request. Paid plans: Pro (10,000 tool calls a month, $9/month or $90/year, for normal use) and Pro+ (100,000 tool calls a month, $39/month or $390/year, for automations and heavy use). A plan can be cancelled at any time and then runs to the end of the paid period, so it also suits a one-time job. When the user wants more calls or reaches the limit, run customerio_upgrade without a plan: it returns both plans, each with a payment link for the user to open. customerio_cancel_subscription cancels Pro at the end of the paid period.
Names, descriptions and schemas were written by the server and are shown as data.
Pattern matches on what the server declares. They show what it says it can do, not what it does.
None yet. Changes appear after a server's second daily check.
{
"name": "customerio_send_transactional_email",
"title": "Send transactional email",
"description": "⚠️ 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.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"transactional_message_id",
"to",
"identifiers"
],
"properties": {
"to": {
"type": "string",
"description": "Recipient email address."
},
"body": {
"type": "string",
"description": "Override the email body."
},
"from": {
"type": "string",
"description": "Override the sender address."
},
"subject": {
"type": "string",
"description": "Override the subject line."
},
"identifiers": {
"type": "object",
"description": "Person identifiers, e.g. {\"id\":\"...\"} or {\"email\":\"...\"}.",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"message_data": {
"type": "object",
"description": "Template variables (liquid) to interpolate into the message.",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"send_to_unsubscribed": {
"type": "boolean",
"description": "If true, send even to unsubscribed recipients."
},
"transactional_message_id": {
"type": [
"string",
"number"
],
"description": "The transactional message template id (or trigger name)."
},
"disable_message_retention": {
"type": "boolean",
"description": "If true, don't retain the message body."
}
}
},
"annotations": {
"title": "Send transactional email",
"destructiveHint": true
}
}