Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
26 changes: 26 additions & 0 deletions .cursor-plugin/plugin.json
Original file line number Diff line number Diff line change
@@ -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"
}
21 changes: 16 additions & 5 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -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
Expand All @@ -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:
Expand Down
8 changes: 8 additions & 0 deletions mcp.json
Original file line number Diff line number Diff line change
@@ -0,0 +1,8 @@
{
"mcpServers": {
"perspective": {
"type": "http",
"url": "https://getperspective.ai/mcp"
}
}
}
Comment thread
cursor[bot] marked this conversation as resolved.
57 changes: 57 additions & 0 deletions skills/perspective-mcp/SKILL.md
Original file line number Diff line number Diff line change
@@ -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.