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.jsonindex 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.mdindex 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 structurediff --git a/third_party/customer-io/.cursor-plugin/plugin.json b/third_party/customer-io/.cursor-plugin/plugin.jsonnew file mode 100644index 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.mdnew file mode 100644index 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/LICENSEnew file mode 100644index 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.mdnew file mode 100644index 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++MITdiff --git a/third_party/customer-io/assets/logo.png b/third_party/customer-io/assets/logo.pngnew file mode 100644index 00000000..d822731eBinary files /dev/null and b/third_party/customer-io/assets/logo.png differdiff --git a/third_party/customer-io/mcp.json b/third_party/customer-io/mcp.jsonnew file mode 100644index 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"+ }+ }+}