Customer.io MCP by usefulapi

Working · 2.3 s

io.usefulapi/customeriov1.17.0 Domain verified

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

Marketing & SEO

Source Website Registry entry

Maintain this server? Claim it

Try it

Call this server's tools from your browser. Nothing to install.

https://customerio.usefulapi.io/mcp

Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.

Tool list from our last check. Connect live to refresh it.

customerio_get_campaign Read-only

Get a single campaign by id. App API: GET /v1/campaigns/{campaign_id}.

campaign_idstring, required

Campaign id.

Tools (13)

customerio_get_campaign

Get a single campaign by id. App API: GET /v1/campaigns/{campaign_id}.

read-only

Argument	Type	Description
campaign_id*	string \| number	Campaign id.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "campaign_id"
  ],
  "properties": {
    "campaign_id": {
      "type": [
        "string",
        "number"
      ],
      "description": "Campaign id."
    }
  }
}

customerio_get_campaign_metrics

Get delivery/engagement metrics for a campaign over time. App API: GET /v1/campaigns/{campaign_id}/metrics.

read-only

Argument	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.

Input schema (JSON)

{
  "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."
    }
  }
}

customerio_get_customer_attributes

Get a single person's attributes (profile fields). App API: GET /v1/customers/{customer_id}/attributes.

read-only

Argument	Type	Description
customer_id*	string	The person's id (or cio_id / email, per your identifier setup).

Input schema (JSON)

{
  "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)."
    }
  }
}

customerio_get_customer_messages

List messages (deliveries) sent to a single person. App API: GET /v1/customers/{customer_id}/messages.

read-only

Argument	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.

Input schema (JSON)

{
  "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."
    }
  }
}

customerio_get_customer_segments

List the segments a single person belongs to. App API: GET /v1/customers/{customer_id}/segments.

read-only

Argument	Type	Description
customer_id*	string	The person's id.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "customer_id"
  ],
  "properties": {
    "customer_id": {
      "type": "string",
      "description": "The person's id."
    }
  }
}

customerio_list_campaigns

List all campaigns in the workspace. App API: GET /v1/campaigns.

read-only

No arguments.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {}
}

customerio_list_collections

List reusable data collections in the workspace. App API: GET /v1/collections.

read-only

No arguments.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {}
}

customerio_list_exports

List data exports in the workspace. App API: GET /v1/exports.

read-only

No arguments.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {}
}

customerio_list_messages

List sent messages (deliveries) across the workspace, filterable by type/campaign/newsletter. App API: GET /v1/messages.

read-only

Argument	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.

Input schema (JSON)

{
  "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."
    }
  }
}

customerio_list_segments

List all segments in the workspace (id + name + type). App API: GET /v1/segments.

read-only

No arguments.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {}
}

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.

read-only

Argument	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"}}]}.

Input schema (JSON)

{
  "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": {}
    }
  }
}

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.

destructive

Argument	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).

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).

destructive

Argument	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.

Input schema (JSON)

{
  "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."
    }
  }
}