Cursor plugin specification and official plugins
TypeScript
Add Klaviyo third-party MCP plugin
Cursor Agent6984e55df73e
diff --git a/.cursor-plugin/marketplace.json b/.cursor-plugin/marketplace.jsonindex fbc1650e..3c6bf84e 100644--- a/.cursor-plugin/marketplace.json+++ b/.cursor-plugin/marketplace.json@@ -172,6 +172,11 @@"name": "amplemarket","source": "third_party/amplemarket","description": "Search people and companies, enrich leads, run sequences."+ },+ {+ "name": "klaviyo",+ "source": "third_party/klaviyo",+ "description": "Manage profiles, segments, campaigns, and flows."}]}diff --git a/README.md b/README.mdindex d600b7c6..30feaa3b 100644--- a/README.md+++ b/README.md@@ -39,6 +39,7 @@ Official Cursor plugins for popular developer tools, frameworks, and SaaS produc| `juicebox` | [Juicebox](third_party/juicebox/) | Cursor | Integrations | Query recruiting analytics, shortlists, and sourcing agents. || `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. |Author values match each plugin’s `plugin.json` `author.name` (Cursor lists `[email protected]` in the manifest).## Repository structurediff --git a/third_party/klaviyo/.cursor-plugin/plugin.json b/third_party/klaviyo/.cursor-plugin/plugin.jsonnew file mode 100644index 00000000..af4a92c4--- /dev/null+++ b/third_party/klaviyo/.cursor-plugin/plugin.json@@ -0,0 +1,34 @@+{+ "name": "klaviyo",+ "displayName": "Klaviyo",+ "version": "1.0.0",+ "minClientVersions": {+ "cursor": "3.13.0"+ },+ "description": "Manage profiles, segments, campaigns, and flows.",+ "author": {+ "name": "Cursor",+ "email": "[email protected]"+ },+ "homepage": "https://developers.klaviyo.com/en/docs/klaviyo_mcp_server",+ "repository": "https://github.com/cursor/plugins",+ "license": "MIT",+ "logo": "assets/logo.png",+ "keywords": [+ "klaviyo",+ "marketing",+ "email",+ "sms",+ "campaigns",+ "segments",+ "mcp"+ ],+ "category": "integrations",+ "tags": [+ "klaviyo",+ "marketing",+ "mcp",+ "email"+ ],+ "mcpServers": "./mcp.json"+}diff --git a/third_party/klaviyo/CHANGELOG.md b/third_party/klaviyo/CHANGELOG.mdnew file mode 100644index 00000000..ec58d99c--- /dev/null+++ b/third_party/klaviyo/CHANGELOG.md@@ -0,0 +1,9 @@+# Changelog++All notable changes to this plugin will be documented here.++## 1.0.0 — initial release++- Added the `klaviyo` MCP server pointing at `https://mcp.klaviyo.com/mcp`.+- Auth uses OAuth — no API key or client ID to configure.+- Logo: Klaviyo's official mark, from the `klaviyo` GitHub organization.diff --git a/third_party/klaviyo/LICENSE b/third_party/klaviyo/LICENSEnew file mode 100644index 00000000..ca2bba77--- /dev/null+++ b/third_party/klaviyo/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/klaviyo/README.md b/third_party/klaviyo/README.mdnew file mode 100644index 00000000..7e8a3577--- /dev/null+++ b/third_party/klaviyo/README.md@@ -0,0 +1,65 @@+# Klaviyo++Cursor plugin that connects agents to [Klaviyo](https://www.klaviyo.com) through Klaviyo's official remote [Model Context Protocol](https://modelcontextprotocol.io/) server.++Build segments, draft campaigns and flows, look up profiles and events, and pull reporting from the signed-in Klaviyo account.++## Install++1. Open **Cursor Settings → Plugins**.+2. Search for **Klaviyo**.+3. Click **Install**, then complete the Klaviyo sign-in prompt.++Or run `/add-plugin klaviyo` in chat.++## MCP++```json+{+ "mcpServers": {+ "klaviyo": {+ "type": "http",+ "url": "https://mcp.klaviyo.com/mcp"+ }+ }+}+```++Auth is OAuth with Dynamic Client Registration. Cursor registers itself and prompts for Klaviyo sign-in when the plugin connects — there is no API key or client ID to configure.++## Before you connect++You need the **Owner**, **Admin**, or **Manager** role on the Klaviyo account. Tool calls run with that user's permissions.++## What agents can do++| Category | Capabilities |+| --- | --- |+| Profiles & events | Look up and update profiles, push events, and manage consent and data-privacy requests |+| Lists & segments | Create and query lists and segments, and manage membership |+| Campaigns & flows | Draft, schedule, and inspect email, SMS, and push campaigns and flows |+| Templates & catalogs | Manage templates, images, coupons, catalogs, and reviews |+| Reporting | Campaign, flow, form, and segment performance reporting |+| Account config | Accounts, brands, tags, sending domains, webhooks, and applications |++The hosted runtime is the source of truth for tool names and schemas.++## Notes++- Tool calls run as the Klaviyo user who authorizes the connection and cannot exceed that user's permissions.+- The full catalog is large. Klaviyo supports URL query parameters to trim it — `?core-tools-only=true` for the core set, `?read-only=true` to drop every write tool, and `?toolsets=profiles:read,campaigns:read` to pick specific toolsets. Edit the plugin's server URL if you want a narrower surface.+- `?disable-tools-with-user-generated-content=true` hides tools that return user-generated content, which is worth setting on shared or sensitive accounts.+- Add `?company=your-company-slug` to pin a specific account when you belong to more than one.+- The URL must have no trailing slash.++## Docs++- Klaviyo MCP server: https://developers.klaviyo.com/en/docs/klaviyo_mcp_server+- MCP server guide (help center): https://help.klaviyo.com/hc/en-us/articles/52833598880923+- Server URL: https://mcp.klaviyo.com/mcp++Logo is Klaviyo's official mark, from the `klaviyo` GitHub organization.++## License++MITdiff --git a/third_party/klaviyo/assets/logo.png b/third_party/klaviyo/assets/logo.pngnew file mode 100644index 00000000..d2113fddBinary files /dev/null and b/third_party/klaviyo/assets/logo.png differdiff --git a/third_party/klaviyo/mcp.json b/third_party/klaviyo/mcp.jsonnew file mode 100644index 00000000..f7d605d0--- /dev/null+++ b/third_party/klaviyo/mcp.json@@ -0,0 +1,8 @@+{+ "mcpServers": {+ "klaviyo": {+ "type": "http",+ "url": "https://mcp.klaviyo.com/mcp"+ }+ }+}