`cio_list_messages`

Pack: customer-io · Endpoint: https://gateway.pipeworx.io/customer-io/mcp

Return a bounded page of Customer.io message deliveries with recipients, channel, campaign or newsletter parent, and delivery engagement timestamps. Answers which messages reached, bounced, opened, clicked, converted, or unsubscribed recipients.

Parameters

Name	Type	Required	Description
`limit`	number	no	Maximum deliveries, default 50 and maximum 100
`start`	string	no	Cursor from the previous response next field
`metric`	string	no
`message_type`	string	no
`campaign_id`	number	no
`start_ts`	number	no	Delivery creation range start as Unix seconds
`end_ts`	number	no	Delivery creation range end as Unix seconds

Example call

Arguments

{
  "_apiKey": "your-customer-io-app-api-key",
  "_region": "us",
  "metric": "converted",
  "limit": 50
}

curl

curl -X POST https://gateway.pipeworx.io/customer-io/mcp \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"cio_list_messages","arguments":{"_apiKey":"your-customer-io-app-api-key","_region":"us","metric":"converted","limit":50}}}'

TypeScript (@pipeworx/sdk)

import { Pipeworx } from '@pipeworx/sdk';
const pipeworx = new Pipeworx();

const result = await pipeworx.call('cio_list_messages', {
  "_apiKey": "your-customer-io-app-api-key",
  "_region": "us",
  "metric": "converted",
  "limit": 50
});

Connect

Add this to your MCP client config, or use one-click install buttons:

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

See Getting Started for client-specific install steps.

cio_list_messages