Skip to main content
Customer.io MCP logo
  • Category: crm
  • Auth: DCR_OAUTH
  • Composio-managed OAuth available? No
  • Tools: 8
  • Triggers: 0
  • Slug: CUSTOMERIO_MCP
  • Version: 20261018_00

Tools

Slug: CUSTOMERIO_MCP_CIO_AUTH_STATUSShow the active authentication state. Reports the authenticated user and account, the workspaces the current OAuth token is allowed to access, and whether an agent service-account JWT can be minted. Use this to diagnose auth errors.

Output

string
required
Authentication state of the caller.
integer
required
Authenticated user ID.
string
required
Customer.io API base URL the agent will call.
boolean
required
Whether an agent JWT could be minted.
string
Display name of the account plan, e.g. Premium, Startup, Free Trial.
string
The account’s plan type, e.g. premium, essentials, startup, basic, trial. Empty when it could not be resolved.
integer
required
Authenticated account ID.
string
Error if verification failed.
string
required
Workspace IDs the OAuth token can access.
Slug: CUSTOMERIO_MCP_CIO_DELETE_APIDelete a resource via the Customer.io API (DELETE only). Always run with dry_run first to preview. Use cio_schema to find the correct path.

Input Parameters

string
gojq expression to filter the response before returning.
string
required
API path including placeholders, e.g. ‘/v1/environments/{environment_id}/campaigns/{campaign_id}’. Placeholders are substituted from params.
object
Parameters as a nested JSON object (pass the object directly; do not JSON-encode it as a string). Keys matching path placeholders are substituted; remaining keys become the query string.
boolean
Validate and return the request without executing it.

Output

string
required
Customer.io API result, filtered result, request preview, or text response.
Slug: CUSTOMERIO_MCP_CIO_PRIMEPrint LLM-ready instructions for using the Customer.io API. ALWAYS call this first in a new task — it contains the authoritative, version-specific rules for how to drive the API via the other cio_* tools.

Output

string
required
Authoritative instructions for using the Customer.io MCP tools.
Slug: CUSTOMERIO_MCP_CIO_READ_APIRead from the Customer.io API (GET only). Use cio_schema first to find the correct path and placeholders. Workspace routing is enforced server-side via the caller’s OAuth token.

Input Parameters

string
gojq expression to filter the response before returning. Use to trim large responses.
number
Page number (1-indexed).
string
required
API path including placeholders, e.g. ‘/v1/environments/{environment_id}/campaigns’. Placeholders are substituted from params.
number
Page size.
object
Parameters as a nested JSON object (pass the object directly; do not JSON-encode it as a string). Keys matching path placeholders are substituted; remaining keys become the query string.
boolean
Validate and return the request without executing it.
boolean
Auto-paginate and return NDJSON for the full dataset.

Output

string
required
Customer.io API result, filtered result, request preview, or text response.
Slug: CUSTOMERIO_MCP_CIO_SCHEMAIntrospect the Customer.io API schema. Use this to discover endpoints before calling cio_read_api / cio_write_api / cio_delete_api — never guess paths or field names. Pass no query to list resources; pass a resource name (‘campaigns’) to list its endpoints; pass ‘resource.method’ (‘campaigns.list’), ‘METHOD /path’, or ‘/path’ for endpoint detail.

Input Parameters

string
One of: ” (list resources), ‘campaigns’ (resource), ‘campaigns.list’ (resource.method), ‘GET /v1/…’ (method + path), or ‘/v1/…’ (all methods for a path).
boolean
Force re-download of API specs.

Output

string
required
Schema discovery result. The value varies with the query.
Slug: CUSTOMERIO_MCP_CIO_SKILLS_LISTList available agent skills — task-specific instruction manuals maintained by Customer.io (routing rules, required params, multi-step workflows).

Input Parameters

boolean
Force re-download of skills.

Output

string
required
Available skills.
string
The account plan these skills are scoped to.
Slug: CUSTOMERIO_MCP_CIO_SKILLS_READRead the full content of a specific agent skill. Paths look like ‘campaigns’ for the main skill or ‘campaigns/examples.md’ for a sub-file — see cio_skills_list for available paths.

Input Parameters

string
required
Skill path, e.g. ‘campaigns’ or ‘campaigns/examples’. See cio_skills_list for available paths.

Output

string
Skill name.
string
Skill or sub-file path.
string
Error message when the skill or file is not found.
string
The requested skill, when a sub-file lookup fails.
string
Markdown content of the skill or sub-file.
string
Sub-file paths available within the requested skill.
string
Top-level skill paths available.
Slug: CUSTOMERIO_MCP_CIO_WRITE_APIWrite to the Customer.io API (POST, PUT, or PATCH). Always run with dry_run first to preview. Use cio_schema to find the correct path, method, and body shape.

Input Parameters

string
gojq expression to filter the response before returning.
object
JSON request body as a nested object (pass the object directly; do not JSON-encode it as a string).
string
required
API path including placeholders, e.g. ‘/v1/environments/{environment_id}/campaigns’. Placeholders are substituted from params.
string
HTTP method: POST, PUT, or PATCH. Defaults to POST.
object
Parameters as a nested JSON object (pass the object directly; do not JSON-encode it as a string). Keys matching path placeholders are substituted; remaining keys become the query string.
boolean
Validate and return the request without executing it.

Output

string
required
Customer.io API result, filtered result, request preview, or text response.