From 4557b53b037d556fa8cd6d54b4fa2ff4a73f3e27 Mon Sep 17 00:00:00 2001 From: Cursor Agent Date: Tue, 1 Sep 2026 09:56:05 +0000 Subject: [PATCH 1/3] Add Cursor Marketplace plugin packaging - Create .cursor-plugin/plugin.json with OAuth-only MCP config - Add mcp.json pointing to https://getperspective.ai/mcp (no secrets) - Add skills/perspective-mcp/SKILL.md to guide when to use Perspective MCP - Update README.md with Cursor Marketplace installation instructions - All paths relative, no secrets, OAuth-friendly URL-only MCP config Co-authored-by: Vinay Puppal --- .cursor-plugin/plugin.json | 25 +++++++++++++++ README.md | 21 +++++++++--- mcp.json | 7 ++++ skills/perspective-mcp/SKILL.md | 57 +++++++++++++++++++++++++++++++++ 4 files changed, 105 insertions(+), 5 deletions(-) create mode 100644 .cursor-plugin/plugin.json create mode 100644 mcp.json create mode 100644 skills/perspective-mcp/SKILL.md diff --git a/.cursor-plugin/plugin.json b/.cursor-plugin/plugin.json new file mode 100644 index 0000000..f0c3b67 --- /dev/null +++ b/.cursor-plugin/plugin.json @@ -0,0 +1,25 @@ +{ + "name": "perspective-ai", + "description": "An AI Concierge replaces static forms with adaptive AI conversations that understand real situations, structure key information automatically, and trigger the right next step.", + "version": "0.0.8", + "author": { + "name": "Perspective AI", + "email": "support@getperspective.ai" + }, + "homepage": "https://getperspective.ai", + "repository": "https://github.com/Perspective-AI/mcp", + "license": "MIT", + "keywords": [ + "mcp", + "mcp-server", + "perspective-ai", + "ai-concierge", + "conversational-ai", + "forms", + "lead-qualification", + "customer-feedback", + "surveys", + "interviews" + ], + "logo": "assets/logo-light.svg" +} diff --git a/README.md b/README.md index 2a3cfc0..f951edf 100644 --- a/README.md +++ b/README.md @@ -39,13 +39,18 @@ The MCP URL is the same for everyone: https://getperspective.ai/mcp ``` -### Claude Code +### Cursor (Marketplace - recommended) -```bash -claude mcp add --transport http perspective https://getperspective.ai/mcp -``` +Install the official Perspective AI plugin from the Cursor Marketplace: -### Cursor and VS Code +1. Open **Customize** in the Cursor sidebar +2. Search for **"Perspective AI"** in the marketplace +3. Click **Install** +4. Complete the OAuth flow when prompted + +The plugin includes the MCP server configuration and a skill that helps your AI assistant know when to use Perspective tools. + +### Cursor and VS Code (manual) Add to your `mcp.json`: ```json @@ -59,6 +64,12 @@ Add to your `mcp.json`: } ``` +### Claude Code + +```bash +claude mcp add --transport http perspective https://getperspective.ai/mcp +``` + ### Claude.ai (web and desktop) Open [the Add custom connector modal](https://claude.ai/settings/connectors?modal=add-custom-connector) and fill: diff --git a/mcp.json b/mcp.json new file mode 100644 index 0000000..a033083 --- /dev/null +++ b/mcp.json @@ -0,0 +1,7 @@ +{ + "mcpServers": { + "perspective": { + "url": "https://getperspective.ai/mcp" + } + } +} diff --git a/skills/perspective-mcp/SKILL.md b/skills/perspective-mcp/SKILL.md new file mode 100644 index 0000000..bfb7078 --- /dev/null +++ b/skills/perspective-mcp/SKILL.md @@ -0,0 +1,57 @@ +--- +name: perspective-mcp +description: Use Perspective AI MCP to design conversation agents, analyze conversations, deploy embeds, and automate follow-ups. Use when working with forms, surveys, customer interviews, lead qualification, or conversational AI. +--- + +# Perspective AI MCP + +Use this MCP server to work with Perspective AI's conversational AI platform. Perspective replaces static forms and surveys with adaptive AI conversations. + +## When to use + +Use Perspective AI MCP when you need to: + +- **Design conversation agents**: Create Concierge (lead qualification), Interviewer (qualitative research), Evaluator (feedback surveys), or Advocate (position representation) agents +- **Analyze conversations**: Pull conversation transcripts, trust scores, and identify drop-off patterns +- **Deploy embeds**: Get embed snippets (fullpage, widget, popup, slider, float, card) for websites +- **Automate workflows**: Create automations (webhooks, email, Slack, HubSpot) triggered by conversation events +- **Manage participants**: Send magic-link invites to specific users + +## Available capabilities + +Once connected via OAuth, you can: + +### Design & iterate +- List and search perspectives across workspaces +- Create new perspectives from natural-language descriptions +- Refine perspectives with conversational feedback +- Get preview links for testing before deployment + +### Deploy & distribute +- Get embed options with code snippets +- Send personalized participant invitations + +### Analyze +- Get aggregate statistics and distributions +- List and filter conversations by status, trust score, date +- Retrieve full conversation details with transcripts +- Batch fetch conversations for bulk analysis + +### Automate +- List, create, update, and delete automations +- Test automations against mock conversations +- Manage integrations (Slack, HubSpot) + +## Example use cases + +Ask your assistant to: + +- "Design a Concierge that qualifies pricing-page leads by budget and timeline" +- "Why are people abandoning my lead-capture concierge this week?" +- "Give me the popup embed snippet for my concierge" +- "Whenever a conversation scores above 80 on trust, push it to HubSpot and ping #sales in Slack" +- "Invite our 20 design partners to my beta-feedback perspective" + +## Authentication + +The MCP server uses OAuth authentication. On first use, your client will open a browser window to complete the OAuth flow. Tokens are managed automatically and can be revoked at Settings → Connected Apps in your Perspective workspace. From 005add4ce2a2a1340cb9280d3a08acd659908555 Mon Sep 17 00:00:00 2001 From: Cursor Agent Date: Tue, 1 Sep 2026 10:02:44 +0000 Subject: [PATCH 2/3] Add explicit skills field to plugin manifest Set "skills": "skills" to explicitly declare the skills directory per Cursor Plugin reference, while maintaining auto-discovery behavior for all skills under skills/ (current and future). Co-authored-by: Vinay Puppal --- .cursor-plugin/plugin.json | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/.cursor-plugin/plugin.json b/.cursor-plugin/plugin.json index f0c3b67..7f0db9b 100644 --- a/.cursor-plugin/plugin.json +++ b/.cursor-plugin/plugin.json @@ -21,5 +21,6 @@ "surveys", "interviews" ], - "logo": "assets/logo-light.svg" + "logo": "assets/logo-light.svg", + "skills": "skills" } From b014efd560012af6371b58a8337d2405351ed012 Mon Sep 17 00:00:00 2001 From: Cursor Agent Date: Tue, 1 Sep 2026 10:10:37 +0000 Subject: [PATCH 3/3] Add explicit type field to mcp.json Set "type": "http" to match README Cursor/VS Code example format. While Cursor can infer transport from url, keeping the field explicit avoids potential client/schema mismatch. Co-authored-by: Vinay Puppal --- mcp.json | 1 + 1 file changed, 1 insertion(+) diff --git a/mcp.json b/mcp.json index a033083..0cedb5e 100644 --- a/mcp.json +++ b/mcp.json @@ -1,6 +1,7 @@ { "mcpServers": { "perspective": { + "type": "http", "url": "https://getperspective.ai/mcp" } }