# Customer Io

> Customer Io is a freemium MCP server for marketing and seo. MCP server reading Customer.io campaigns, segments and message delivery data for marketers. It can run locally on your machine or as a hosted remote server.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Starting price:** $49 a month
- **Platforms:** API, CLI, self-hosted
- **Website:** https://pipeworx.io/packs/customer-io
- **Repository:** https://github.com/pipeworx-io/mcp-customer-io
- **MCP Registry name:** io.github.pipeworx-io/customer-io
- **Categories:** [marketing and SEO](https://ai-powered.com/categories/marketing-and-seo)
- **Listing updated:** 2026-11-18

## About

The README describes this as a read-only bridge to the Customer.io Journeys App API, exposing campaign lists, per-campaign delivery and engagement metrics, audience segments, and message delivery records. It is run through the Pipeworx gateway, so an AI client can query lifecycle marketing data without building its own Customer.io integration.

Requests need a scoped Customer.io App API key passed per call as an argument, and an EU-region workspace is selected with a region parameter. The pack is not affiliated with Customer.io, and the gateway also lists shared Pipeworx meta-tools alongside the four pack tools.

This suits marketing operations staff and developers who want an assistant to answer questions about which campaigns are running, how they performed over time, and which messages were opened, clicked, or bounced.

## Features

- **Campaign listing:** Returns lifecycle campaigns with IDs, state, trigger configuration, actions, tags and timestamps.
- **Campaign metrics:** Provides time-bucketed delivery, bounce, open, click, unsubscribe and conversion counts for one campaign.
- **Segment listing:** Lists audience segments with type, build progress, tags and timestamps.
- **Message delivery inspection:** Pages through message deliveries with recipients, channel and engagement timestamps.
- **Read-only access:** The README states the pack only reads data and does not modify Customer.io workspaces.
- **Regional workspace support:** An EU region option is available for EU-hosted Customer.io workspaces, defaulting to US.

## Good for

- Check which lifecycle campaigns are active, drafted or stopped
- Compare campaign delivery and engagement rates over time
- Find which audience segments are available for targeting
- Investigate bounced or unopened messages for a given campaign

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http customer-io https://gateway.pipeworx.io/customer-io/mcp
```

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://gateway.pipeworx.io/customer-io/mcp
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "customer-io": {
      "url": "https://gateway.pipeworx.io/customer-io/mcp"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "customer-io": {
      "type": "http",
      "url": "https://gateway.pipeworx.io/customer-io/mcp"
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "customer-io": {
      "serverUrl": "https://gateway.pipeworx.io/customer-io/mcp"
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "customer-io": {
      "type": "http",
      "url": "https://gateway.pipeworx.io/customer-io/mcp"
    }
  }
}
```

## Tools

- `cio_list_campaigns`: List lifecycle campaigns with state and configuration.
- `cio_campaign_metrics`: Retrieve time-bucketed delivery and engagement metrics for a campaign.
- `cio_list_segments`: List audience segments and build state.
- `cio_list_messages`: Inspect bounded message deliveries and recipient-level outcomes.

## FAQ

### Does the pack modify campaigns in Customer.io?

No. The README states the pack is read-only.

### How is authentication handled?

A scoped Customer.io App API key is passed as an _apiKey argument on each call. The README says the Pipeworx gateway does not supply a key for this pack.

### Can I use it with an EU workspace?

Yes. Setting the region to eu selects an EU-region workspace; the default is US.

### Is there a cost to use the gateway?

The pricing page describes a free account with 200 tool calls a day and 50 a day anonymously. Paid tiers use credits; the README notes that Pipeworx does not mark up upstream keys you supply.

### Is Customer Io free?

Customer Io has a free plan, with paid plans for more usage or features. Paid plans start at $49 a month.

### How do I add Customer Io to Claude Code?

Run this command in your terminal: claude mcp add --transport http customer-io https://gateway.pipeworx.io/customer-io/mcp

### What are the best alternatives to Customer Io?

The closest alternatives to Customer Io are Customer.io MCP by usefulapi, Google_ads, Facebook_ads, Linkedin_ads and Moosend MCP by usefulapi.

## Where this comes from

- Description: written from the project's README, the project's website and its MCP Registry entry.
- Install steps: from the official MCP Registry entry.

## Alternatives

- [Customer.io MCP by usefulapi](https://ai-powered.com/mcp/customer-io-mcp-by-usefulapi): Customer.io MCP by usefulapi is a freemium MCP server for marketing and seo.
- [Google_ads](https://ai-powered.com/mcp/google-ads-7): Google_ads is a freemium MCP server for marketing and seo.
- [Facebook_ads](https://ai-powered.com/mcp/facebook-ads): Facebook_ads is a freemium MCP server for marketing and seo.
- [Linkedin_ads](https://ai-powered.com/mcp/linkedin-ads-3): Linkedin_ads is a freemium MCP server for marketing and seo.
- [Moosend MCP by usefulapi](https://ai-powered.com/mcp/moosend-mcp-by-usefulapi): Moosend MCP by usefulapi is a freemium MCP server for marketing and seo.
- [Emma MCP by usefulapi](https://ai-powered.com/mcp/emma-mcp-by-usefulapi): Emma MCP by usefulapi is a freemium MCP server for marketing and seo.
- [EmailOctopus MCP by usefulapi](https://ai-powered.com/mcp/emailoctopus-mcp-by-usefulapi): EmailOctopus MCP by usefulapi is a freemium MCP server for marketing and seo.
- [Space Monkey Mailchimp Dashboard](https://ai-powered.com/mcp/space-monkey-mailchimp-dashboard): Space Monkey Mailchimp Dashboard is an MCP server for marketing and seo.

---
Source: https://ai-powered.com/mcp/customer-io
