Skip to content

Cursor plugin specification and official plugins

TypeScript

Add Customer.io third-party MCP plugin

Cursor Agentf37b63481674
diff --git a/.cursor-plugin/marketplace.json b/.cursor-plugin/marketplace.json
index 3c6bf84e..2fe98c76 100644
--- a/.cursor-plugin/marketplace.json
+++ b/.cursor-plugin/marketplace.json
@@ -177,6 +177,11 @@
"name": "klaviyo",
"source": "third_party/klaviyo",
"description": "Manage profiles, segments, campaigns, and flows."
+ },
+ {
+ "name": "customer-io",
+ "source": "third_party/customer-io",
+ "description": "Build campaigns, manage segments, and query people."
}
]
}
diff --git a/README.md b/README.md
index 30feaa3b..526cda7f 100644
--- a/README.md
+++ b/README.md
@@ -40,6 +40,7 @@ Official Cursor plugins for popular developer tools, frameworks, and SaaS produc
| `outreach` | [Outreach](third_party/outreach/) | Cursor | Integrations | Search sequences, prospects, and Kaia meetings. |
| `amplemarket` | [Amplemarket](third_party/amplemarket/) | Cursor | Integrations | Search people and companies, enrich leads, run sequences. |
| `klaviyo` | [Klaviyo](third_party/klaviyo/) | Cursor | Integrations | Manage profiles, segments, campaigns, and flows. |
+| `customer-io` | [Customer.io](third_party/customer-io/) | Cursor | Integrations | Build campaigns, manage segments, and query people. |
Author values match each plugin’s `plugin.json` `author.name` (Cursor lists `[email protected]` in the manifest).
## Repository structure
diff --git a/third_party/customer-io/.cursor-plugin/plugin.json b/third_party/customer-io/.cursor-plugin/plugin.json
new file mode 100644
index 00000000..bb2bb093
--- /dev/null
+++ b/third_party/customer-io/.cursor-plugin/plugin.json
@@ -0,0 +1,34 @@
+{
+ "name": "customer-io",
+ "displayName": "Customer.io",
+ "version": "1.0.0",
+ "minClientVersions": {
+ "cursor": "3.13.0"
+ },
+ "description": "Build campaigns, manage segments, and query people.",
+ "author": {
+ "name": "Cursor",
+ "email": "[email protected]"
+ },
+ "homepage": "https://docs.customer.io/ai/mcp/",
+ "repository": "https://github.com/cursor/plugins",
+ "license": "MIT",
+ "logo": "assets/logo.png",
+ "keywords": [
+ "customer.io",
+ "customerio",
+ "marketing",
+ "campaigns",
+ "segments",
+ "messaging",
+ "mcp"
+ ],
+ "category": "integrations",
+ "tags": [
+ "customer-io",
+ "marketing",
+ "mcp",
+ "campaigns"
+ ],
+ "mcpServers": "./mcp.json"
+}
diff --git a/third_party/customer-io/CHANGELOG.md b/third_party/customer-io/CHANGELOG.md
new file mode 100644
index 00000000..18ed8b7f
--- /dev/null
+++ b/third_party/customer-io/CHANGELOG.md
@@ -0,0 +1,9 @@
+# Changelog
+
+All notable changes to this plugin will be documented here.
+
+## 1.0.0 — initial release
+
+- Added the `customer-io` MCP server pointing at `https://mcp.customer.io/mcp`.
+- Auth uses OAuth — no API key or client ID to configure.
+- Logo: Customer.io's official mark, from the `customerio` GitHub organization.
diff --git a/third_party/customer-io/LICENSE b/third_party/customer-io/LICENSE
new file mode 100644
index 00000000..ca2bba77
--- /dev/null
+++ b/third_party/customer-io/LICENSE
@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Cursor
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
diff --git a/third_party/customer-io/README.md b/third_party/customer-io/README.md
new file mode 100644
index 00000000..0d86a944
--- /dev/null
+++ b/third_party/customer-io/README.md
@@ -0,0 +1,65 @@
+# Customer.io
+
+Cursor plugin that connects agents to [Customer.io](https://customer.io) through Customer.io's official remote [Model Context Protocol](https://modelcontextprotocol.io/) server.
+
+Inspect workspace data, build and manage campaigns and one-time sends, work with segments and people, and query the Journeys and Data Pipelines APIs in the signed-in Customer.io workspace.
+
+## Install
+
+1. Open **Cursor Settings → Plugins**.
+2. Search for **Customer.io**.
+3. Click **Install**, then complete the Customer.io sign-in prompt.
+
+Or run `/add-plugin customer-io` in chat.
+
+## MCP
+
+```json
+{
+ "mcpServers": {
+ "customer-io": {
+ "type": "http",
+ "url": "https://mcp.customer.io/mcp"
+ }
+ }
+}
+```
+
+Auth is OAuth 2.1 with PKCE and Dynamic Client Registration. Cursor registers itself and prompts for Customer.io sign-in when the plugin connects — there is no API key or client ID to configure. During the flow you choose which workspaces and scopes to grant.
+
+## Before you connect
+
+A Customer.io account admin has to turn MCP on first under **Settings → AI**, including the separate toggles for editing live data and reading sensitive data. Until that happens the connection will fail at authorization.
+
+This plugin points at the **US** region. If your account is in the EU, change the server URL to `https://mcp-eu.customer.io/mcp`.
+
+## What agents can do
+
+| Category | Capabilities |
+| --- | --- |
+| Workspace context | Prime the agent with workspace structure, then browse object and attribute schemas |
+| People & objects | Look up people, objects, and their attributes, relationships, and activity |
+| Segments | Create, inspect, and query segments and their membership |
+| Campaigns & sends | Build and manage campaigns, newsletters, and one-time sends |
+| Data pipelines | Query CDP sources, destinations, and delivery data |
+
+The hosted runtime is the source of truth for tool names and schemas.
+
+## Notes
+
+- Tool calls run as the Customer.io user who authorizes the connection and are scoped to the workspaces granted during OAuth.
+- The tool surface is deliberately small: rather than one tool per object, the server exposes a context primer, a schema browser, and verb-scoped API proxies that keep reads separate from writes and deletes so read tools can be auto-approved.
+- Set the transport type to `http`. Customer.io does not support the `sse` transport.
+- EU-region accounts must use `https://mcp-eu.customer.io/mcp`; the US URL will not serve EU data.
+
+## Docs
+
+- Customer.io MCP: https://docs.customer.io/ai/mcp/
+- Connect an IDE: https://docs.customer.io/ai/mcp/ide/
+- Server URL: https://mcp.customer.io/mcp
+
+Logo is Customer.io's official mark, from the `customerio` GitHub organization.
+
+## License
+
+MIT
diff --git a/third_party/customer-io/assets/logo.png b/third_party/customer-io/assets/logo.png
new file mode 100644
index 00000000..d822731e
Binary files /dev/null and b/third_party/customer-io/assets/logo.png differ
diff --git a/third_party/customer-io/mcp.json b/third_party/customer-io/mcp.json
new file mode 100644
index 00000000..b158bacb
--- /dev/null
+++ b/third_party/customer-io/mcp.json
@@ -0,0 +1,8 @@
+{
+ "mcpServers": {
+ "customer-io": {
+ "type": "http",
+ "url": "https://mcp.customer.io/mcp"
+ }
+ }
+}