Skip to content
MCP server

Customer Io

MCP server reading Customer.io campaigns, segments and message delivery data for marketers

Install
Pricing
Freemium
Platforms
API, CLI, self-hosted
Runs
Locally or Remotely
Version
0.2.1
Listing updated
today

Similar MCP servers

About Customer Io

Customer Io is a freemium MCP server for marketing and seo. It can run locally on your machine or as a hosted remote server.

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.

Install

Run in a terminal

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

Add to Settings → Connectors → Add custom connector

https://gateway.pipeworx.io/customer-io/mcp
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

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

Add to .vscode/mcp.json

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

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

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

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

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

Using several servers? Build one config file with the MCP config generator.

Configuration

  • PIPEWORX_API_KEYOptional Pipeworx API key. Without it calls are anonymous and capped daily; a free key raises the cap.

Tools this server provides (4)

Taken from the project documentation; the running server may differ.

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.

What it does

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

Pricing

Freemium, from $49 a month

Free tier of 200 calls/day with a free account; paid usage billed in credits

Prices change. Check pipeworx.io before you buy.

Customer Io 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.

How AIPoweredBot checks servers