Cursor plugin specification and official plugins
TypeScript
Align Clay third-party plugin docs with Ashby/Apollo template.
Rohan Shaha4916a43c2e9
diff --git a/.cursor-plugin/marketplace.json b/.cursor-plugin/marketplace.jsonindex 37a88725..c4f8c40e 100644--- a/.cursor-plugin/marketplace.json+++ b/.cursor-plugin/marketplace.json@@ -131,7 +131,7 @@{"name": "clay","source": "third_party/clay",- "description": "Connect Cursor to Clay via Clay's hosted MCP server — find and enrich people and companies across 150+ data providers, run AI research agents, and trigger your team's approved Clay workflows."+ "description": "Connect Cursor to Clay — find and enrich people and companies across 150+ data providers, run AI research agents, and trigger your team's approved Clay workflows — via Clay's official hosted MCP server."}]}diff --git a/third_party/clay/.cursor-plugin/plugin.json b/third_party/clay/.cursor-plugin/plugin.jsonindex b1d6522a..1fec6429 100644--- a/third_party/clay/.cursor-plugin/plugin.json+++ b/third_party/clay/.cursor-plugin/plugin.json@@ -1,18 +1,34 @@{- "name": "clay",- "displayName": "Clay",- "version": "1.0.0",- "description": "Connect Cursor to Clay via Clay's hosted MCP server — find and enrich people and companies across 150+ data providers, run AI research agents, and trigger your team's approved Clay workflows.",- "author": {- "name": "Cursor",- "email": "[email protected]"- },- "homepage": "https://university.clay.com/docs/connect-to-clay-mcp",- "repository": "https://github.com/cursor/plugins",- "license": "MIT",- "logo": "assets/logo.png",- "keywords": ["clay", "enrichment", "prospecting", "gtm", "sales", "data", "mcp"],- "category": "integrations",- "tags": ["mcp", "sales", "data"],- "mcpServers": "./mcp.json"+ "name": "clay",+ "displayName": "Clay",+ "version": "1.0.0",+ "minClientVersions": {+ "cursor": "3.13.0"+ },+ "description": "Connect Cursor to Clay — find and enrich people and companies across 150+ data providers, run AI research agents, and trigger your team's approved Clay workflows — via Clay's official hosted MCP server.",+ "author": {+ "name": "Cursor",+ "email": "[email protected]"+ },+ "homepage": "https://university.clay.com/docs/connect-to-clay-mcp",+ "repository": "https://github.com/cursor/plugins",+ "license": "MIT",+ "logo": "assets/logo.png",+ "keywords": [+ "clay",+ "enrichment",+ "prospecting",+ "gtm",+ "sales",+ "data",+ "mcp"+ ],+ "category": "integrations",+ "tags": [+ "clay",+ "sales",+ "enrichment",+ "mcp"+ ],+ "mcpServers": "./mcp.json"}diff --git a/third_party/clay/CHANGELOG.md b/third_party/clay/CHANGELOG.mdindex 203cb7a9..a14a23a3 100644--- a/third_party/clay/CHANGELOG.md+++ b/third_party/clay/CHANGELOG.md@@ -1,5 +1,8 @@# Changelog-## 1.0.0+All notable changes to this plugin will be documented here.-- Initial release: Clay hosted MCP server (`https://api.clay.com/v3/mcp`) with OAuth 2.1 Dynamic Client Registration — no manual configuration required.+## 1.0.0 — initial release++- Added the `clay` MCP server backed by Clay's hosted MCP (`https://api.clay.com/v3/mcp`).+- Auth uses OAuth 2.1 with Dynamic Client Registration and PKCE — no API key or client ID to configure.diff --git a/third_party/clay/README.md b/third_party/clay/README.mdindex 1354ebc1..9b7e90ed 100644--- a/third_party/clay/README.md+++ b/third_party/clay/README.md@@ -1,40 +1,59 @@# Clay-Connect Cursor to [Clay](https://www.clay.com) via Clay's hosted MCP server. Find and enrich people and companies across 150+ data providers, run AI research agents, and trigger your team's approved Clay workflows — directly from Cursor.+Cursor plugin that connects agents to [Clay](https://www.clay.com) through Clay's official hosted [Model Context Protocol](https://modelcontextprotocol.io/) server.-## What you can do+Find and enrich people and companies across 150+ data providers, run AI research agents (Claygent), and trigger your team's approved Clay workflows from the signed-in Clay workspace.-- **Find people and companies** — search Clay's data universe with natural-language criteria.-- **Enrich records** — pull emails, phone numbers, firmographics, technographics, and more across 150+ providers.-- **Run AI research agents** — Claygent answers open-ended research questions about accounts and contacts.-- **Trigger workflows** — kick off Clay tables and workflows your team has approved for MCP access.+## Install-## Installation+1. Open **Cursor Settings → Plugins**.+2. Search for **Clay**.+3. Click **Install**, then complete the Clay sign-in prompt.-1. Install this plugin from the Cursor marketplace.-2. When Cursor connects to the Clay MCP server for the first time, your browser opens to sign in at `app.clay.com`.-3. Approve the connection. That's it — no API keys or client IDs to copy.+Or run `/add-plugin clay` in chat.-Clay's MCP server supports OAuth 2.1 with Dynamic Client Registration (DCR), so Cursor registers itself automatically and completes the standard PKCE authorization flow.+## MCP-## Requirements+```json+{+ "mcpServers": {+ "clay": {+ "type": "http",+ "url": "https://api.clay.com/v3/mcp"+ }+ }+}+```-- A Clay account with access to a workspace.-- Your Clay workspace admin may need to allow MCP client connections (Clay workspace Settings → MCP). If sign-in succeeds but tools fail, check with your admin.+Auth is OAuth 2.1 against Clay with Dynamic Client Registration (DCR) and PKCE. Cursor registers itself and prompts for Clay sign-in when the plugin connects — there is no API key or client ID to configure.-## MCP server+## Before you connect-| Server | URL | Auth |-| ------ | --- | ---- |-| `clay` | `https://api.clay.com/v3/mcp` | OAuth 2.1 (DCR + PKCE), handled automatically by Cursor |+You need a Clay account with access to a workspace.-## For workspace admins+Your Clay workspace admin may need to allow MCP client connections under Clay workspace **Settings → MCP**. If sign-in succeeds but tools fail, check with your admin.-- Connections made through this plugin appear in your Clay workspace's MCP client list, labeled with the Cursor client name.-- Access is scoped to what the signed-in Clay user can do; workflow triggers are limited to workflows approved for MCP access.-- To revoke access, remove the client from your workspace's MCP settings in Clay.+## What agents can do-## Support+| Category | Capabilities |+| --- | --- |+| People & companies | Search Clay's data universe with natural-language criteria |+| Enrichment | Pull emails, phone numbers, firmographics, technographics, and other data points across 150+ providers |+| Research | Ask Claygent open-ended questions about accounts and contacts |+| Workflows | Trigger Clay tables and workflows your team has approved for MCP access |-- Clay MCP docs: <https://university.clay.com/docs/connect-to-clay-mcp>-- Issues with this plugin: <https://github.com/cursor/plugins/issues>+## Notes++- Tool calls run as the Clay user who authorizes the connection and cannot exceed that user's permissions.+- Workflow triggers are limited to workflows approved for MCP access in the Clay workspace.+- Connections appear in your Clay workspace's MCP client list, labeled with the Cursor client name.+- Revoke access at any time from Clay workspace **Settings → MCP**.++## Docs++- Connect to Clay MCP: https://university.clay.com/docs/connect-to-clay-mcp+- Server URL: https://api.clay.com/v3/mcp++## License++MITdiff --git a/third_party/clay/mcp.json b/third_party/clay/mcp.jsonindex 544268c3..6cf0a950 100644--- a/third_party/clay/mcp.json+++ b/third_party/clay/mcp.json@@ -1,8 +1,8 @@{- "mcpServers": {- "clay": {- "type": "http",- "url": "https://api.clay.com/v3/mcp"- }- }+ "mcpServers": {+ "clay": {+ "type": "http",+ "url": "https://api.clay.com/v3/mcp"+ }+ }}