> ## Documentation Index
> Fetch the complete documentation index at: https://composio-preview.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Customer.io MCP

> Work with Customer.io people, campaigns, broadcasts, and workspace configuration.

![Customer.io MCP logo](https://mintcdn.com/composio-preview/VNLruGH5mLZqXdPH/images/toolkits/customerio_mcp.svg?fit=max\&auto=format\&n=VNLruGH5mLZqXdPH\&q=85\&s=a0c252ee718497971b38dfda0a5c2316)

* **Category:** crm
* **Auth:** DCR\_OAUTH
* **Composio-managed OAuth available?** No
* **Tools:** 8
* **Triggers:** 0
* **Slug:** `CUSTOMERIO_MCP`
* **Version:** 20261018\_00

## Tools

> [accordion] Cio auth status
>
> **Slug:** `CUSTOMERIO_MCP_CIO_AUTH_STATUS`
>
> Show 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
>
> **status** `string` *required*
>
> Authentication state of the caller.
>
> **user\_id** `integer` *required*
>
> Authenticated user ID.
>
> **base\_url** `string` *required*
>
> Customer.io API base URL the agent will call.
>
> **verified** `boolean` *required*
>
> Whether an agent JWT could be minted.
>
> **plan\_name** `string`
>
> Display name of the account plan, e.g. Premium, Startup, Free Trial.
>
> **plan\_type** `string`
>
> The account's plan type, e.g. premium, essentials, startup, basic, trial. Empty when it could not be resolved.
>
> **account\_id** `integer` *required*
>
> Authenticated account ID.
>
> **verify\_error** `string`
>
> Error if verification failed.
>
> **allowed\_workspace\_ids** `string` *required*
>
> Workspace IDs the OAuth token can access.

> [accordion] Cio delete api
>
> **Slug:** `CUSTOMERIO_MCP_CIO_DELETE_API`
>
> Delete 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
>
> **jq** `string`
>
> gojq expression to filter the response before returning.
>
> **path** `string` *required*
>
> API path including placeholders, e.g. '/v1/environments/\{environment\_id}/campaigns/\{campaign\_id}'. Placeholders are substituted from params.
>
> **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.
>
> **dry\_run** `boolean`
>
> Validate and return the request without executing it.
>
> #### Output
>
> **data** `string` *required*
>
> Customer.io API result, filtered result, request preview, or text response.

> [accordion] Cio prime
>
> **Slug:** `CUSTOMERIO_MCP_CIO_PRIME`
>
> Print 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
>
> **instructions** `string` *required*
>
> Authoritative instructions for using the Customer.io MCP tools.

> [accordion] Cio read api
>
> **Slug:** `CUSTOMERIO_MCP_CIO_READ_API`
>
> Read 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
>
> **jq** `string`
>
> gojq expression to filter the response before returning. Use to trim large responses.
>
> **page** `number`
>
> Page number (1-indexed).
>
> **path** `string` *required*
>
> API path including placeholders, e.g. '/v1/environments/\{environment\_id}/campaigns'. Placeholders are substituted from params.
>
> **limit** `number`
>
> Page size.
>
> **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.
>
> **dry\_run** `boolean`
>
> Validate and return the request without executing it.
>
> **page\_all** `boolean`
>
> Auto-paginate and return NDJSON for the full dataset.
>
> #### Output
>
> **data** `string` *required*
>
> Customer.io API result, filtered result, request preview, or text response.

> [accordion] Cio schema
>
> **Slug:** `CUSTOMERIO_MCP_CIO_SCHEMA`
>
> Introspect 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
>
> **query** `string`
>
> One of: '' (list resources), 'campaigns' (resource), 'campaigns.list' (resource.method), 'GET /v1/...' (method + path), or '/v1/...' (all methods for a path).
>
> **refresh** `boolean`
>
> Force re-download of API specs.
>
> #### Output
>
> **data** `string` *required*
>
> Schema discovery result. The value varies with the query.

> [accordion] Cio skills list
>
> **Slug:** `CUSTOMERIO_MCP_CIO_SKILLS_LIST`
>
> List available agent skills — task-specific instruction manuals maintained by Customer.io (routing rules, required params, multi-step workflows).
>
> #### Input Parameters
>
> **refresh** `boolean`
>
> Force re-download of skills.
>
> #### Output
>
> **skills** `string` *required*
>
> Available skills.
>
> **account\_plan** `string`
>
> The account plan these skills are scoped to.

> [accordion] Cio skills read
>
> **Slug:** `CUSTOMERIO_MCP_CIO_SKILLS_READ`
>
> Read 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
>
> **path** `string` *required*
>
> Skill path, e.g. 'campaigns' or 'campaigns/examples'. See cio\_skills\_list for available paths.
>
> #### Output
>
> **name** `string`
>
> Skill name.
>
> **path** `string`
>
> Skill or sub-file path.
>
> **error** `string`
>
> Error message when the skill or file is not found.
>
> **skill** `string`
>
> The requested skill, when a sub-file lookup fails.
>
> **content** `string`
>
> Markdown content of the skill or sub-file.
>
> **available\_files** `string`
>
> Sub-file paths available within the requested skill.
>
> **available\_skills** `string`
>
> Top-level skill paths available.

> [accordion] Cio write api
>
> **Slug:** `CUSTOMERIO_MCP_CIO_WRITE_API`
>
> Write 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
>
> **jq** `string`
>
> gojq expression to filter the response before returning.
>
> **body** `object`
>
> JSON request body as a nested object (pass the object directly; do not JSON-encode it as a string).
>
> **path** `string` *required*
>
> API path including placeholders, e.g. '/v1/environments/\{environment\_id}/campaigns'. Placeholders are substituted from params.
>
> **method** `string`
>
> HTTP method: POST, PUT, or PATCH. Defaults to POST.
>
> **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.
>
> **dry\_run** `boolean`
>
> Validate and return the request without executing it.
>
> #### Output
>
> **data** `string` *required*
>
> Customer.io API result, filtered result, request preview, or text response.
