diff --git a/.cursor-plugin/plugin.json b/.cursor-plugin/plugin.json new file mode 100644 index 0000000..7f0db9b --- /dev/null +++ b/.cursor-plugin/plugin.json @@ -0,0 +1,26 @@ +{ + "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", + "skills": "skills" +} 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..0cedb5e --- /dev/null +++ b/mcp.json @@ -0,0 +1,8 @@ +{ + "mcpServers": { + "perspective": { + "type": "http", + "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.