Customer.io MCP by usefulapi
by usefulapi.io · remote · no sign-in to list tools · v1.16.3 · published by io.usefulapi
Query people, segments, campaigns, and message deliveries; send transactional email or broadcasts.
13 tools: 2 can delete or cancel things and 11 only read.
Scanned Oct 21, 2026
- Deletes or cancels2Claude Code: deny: see these tools
- Can't be undone0Claude Code: ask
- Changes things0Claude Code: ask
- Only reads11Claude Code: allow: see these tools
No check matched anything in the tool definitions. No finding is not a safety guarantee. How the checks work.
claude mcp add --transport http customerio https://customerio.usefulapi.io/mcpTools
Open a tool for its reasons and full description. Descriptions are the publisher's own words, shown as they are.
13 tools
Deletes or cancels 2Claude Code: deny
customerio_send_transactional_email⚠[U+FE0F] SENDS A REAL EMAIL.No findings
Why it is in this group
- The name "customerio_send_transactional_email" says "send": a word for sending, and what is sent cannot be taken back.
- The input addresses people (input.to): what it sends cannot be taken back.
- The server marks it destructive (destructiveHint: true).
Description, as the server wrote itContains invisible characters, shown as [U+…] ⚠[U+FE0F] 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.
Annotations the server declares
- title: Send transactional email
- destructiveHint: true
customerio_trigger_broadcast⚠[U+FE0F] SENDS TO REAL RECIPIENTS.No findings
Why it is in this group
- The name "customerio_trigger_broadcast" says "trigger": a word for a change.
- The name "customerio_trigger_broadcast" also says "broadcast": a word for sending, and what is sent cannot be taken back.
- The input addresses people (input.recipients): what it sends cannot be taken back.
- The server marks it destructive (destructiveHint: true).
Description, as the server wrote itContains invisible characters, shown as [U+…] ⚠[U+FE0F] 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).
Annotations the server declares
- title: Trigger broadcast
- destructiveHint: true
Only reads 11Claude Code: allow
customerio_get_campaignGet a single campaign by id.No findings
Why it is in this group
- The name "customerio_get_campaign" says "get": a word for reading.
Description, as the server wrote it Get a single campaign by id. App API: GET /v1/campaigns/{campaign_id}.
Annotations the server declares
- title: Get campaign
- readOnlyHint: true
customerio_get_campaign_metricsGet delivery/engagement metrics for a campaign over time.No findings
Why it is in this group
- The name "customerio_get_campaign_metrics" says "get": a word for reading.
Description, as the server wrote it Get delivery/engagement metrics for a campaign over time. App API: GET /v1/campaigns/{campaign_id}/metrics.
Annotations the server declares
- title: Get campaign metrics
- readOnlyHint: true
customerio_get_customer_attributesGet a single person's attributes (profile fields).No findings
Why it is in this group
- The name "customerio_get_customer_attributes" says "get": a word for reading.
Description, as the server wrote it Get a single person's attributes (profile fields). App API: GET /v1/customers/{customer_id}/attributes.
Annotations the server declares
- title: Get customer attributes
- readOnlyHint: true
customerio_get_customer_messagesList messages (deliveries) sent to a single person.No findings
Why it is in this group
- The name "customerio_get_customer_messages" says "get": a word for reading.
Description, as the server wrote it List messages (deliveries) sent to a single person. App API: GET /v1/customers/{customer_id}/messages.
Annotations the server declares
- title: Get customer messages
- readOnlyHint: true
customerio_get_customer_segmentsList the segments a single person belongs to.No findings
Why it is in this group
- The name "customerio_get_customer_segments" says "get": a word for reading.
Description, as the server wrote it List the segments a single person belongs to. App API: GET /v1/customers/{customer_id}/segments.
Annotations the server declares
- title: Get customer segments
- readOnlyHint: true
customerio_list_campaignsList all campaigns in the workspace.No findings
Why it is in this group
- The name "customerio_list_campaigns" says "list": a word for reading.
Description, as the server wrote it List all campaigns in the workspace. App API: GET /v1/campaigns.
Annotations the server declares
- title: List campaigns
- readOnlyHint: true
customerio_list_collectionsList reusable data collections in the workspace.No findings
Why it is in this group
- The name "customerio_list_collections" says "list": a word for reading.
Description, as the server wrote it List reusable data collections in the workspace. App API: GET /v1/collections.
Annotations the server declares
- title: List collections
- readOnlyHint: true
customerio_list_exportsList data exports in the workspace.No findings
Why it is in this group
- The name "customerio_list_exports" says "list": a word for reading.
Description, as the server wrote it List data exports in the workspace. App API: GET /v1/exports.
Annotations the server declares
- title: List exports
- readOnlyHint: true
customerio_list_messagesList sent messages (deliveries) across the workspace, filterable by type/campaign/newsletter.No findings
Why it is in this group
- The name "customerio_list_messages" says "list": a word for reading.
Description, as the server wrote it List sent messages (deliveries) across the workspace, filterable by type/campaign/newsletter. App API: GET /v1/messages.
Annotations the server declares
- title: List messages
- readOnlyHint: true
customerio_list_segmentsList all segments in the workspace (id + name + type).No findings
Why it is in this group
- The name "customerio_list_segments" says "list": a word for reading.
Description, as the server wrote it List all segments in the workspace (id + name + type). App API: GET /v1/segments.
Annotations the server declares
- title: List segments
- readOnlyHint: true
customerio_search_customersSearch/list people by a Customer.io filter (segment or attribute conditions).No findings
Why it is in this group
- The name "customerio_search_customers" says "search": a word for reading.
Description, as the server wrote 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.
Annotations the server declares
- title: Search customers
- readOnlyHint: true
This is not a safety rating, and no finding is not a safety guarantee. The groups and findings come from fixed checks of the tool definitions the server returned on the date shown, not from its code or what it does when called. How the checks work.
Install
Pinned to version 1.16.3. Values in angle brackets are yours to fill in.
claude mcp add --transport http customerio https://customerio.usefulapi.io/mcpRun in a terminal.
Claude Code permissions
Allow the reads, ask before a change, deny the deletes. Paste into .claude/settings.json.
{
"permissions": {
"allow": [
"mcp__customerio__customerio_search_customers",
"mcp__customerio__customerio_get_customer_attributes",
"mcp__customerio__customerio_get_customer_segments",
"mcp__customerio__customerio_get_customer_messages",
"mcp__customerio__customerio_list_segments",
"mcp__customerio__customerio_list_campaigns",
"mcp__customerio__customerio_get_campaign",
"mcp__customerio__customerio_get_campaign_metrics",
"mcp__customerio__customerio_list_messages",
"mcp__customerio__customerio_list_exports",
"mcp__customerio__customerio_list_collections"
],
"ask": [],
"deny": [
"mcp__customerio__customerio_send_transactional_email",
"mcp__customerio__customerio_trigger_broadcast"
]
}
}Tools that only read are allowed, tools that change things ask first, tools that delete or cancel are denied. It assumes the server is installed as customerio. Review it before you use it.