Model Context Protocol

Connect AI Clients
to Your Workspace

Use ChatGPT, Claude, Cursor, VS Code, or any MCP-compatible AI to create surveys, analyze responses, and manage research — all with natural language.

URLhttps://mcp.survona.com/mcp|AuthAPI Key or Browser Login

Up and running in 3 steps

01

Choose Your Auth Method

ChatGPT uses browser login (OAuth 2.0) — no key needed. For other clients, create an API key in Settings → API Keys.

Open Dashboard
02

Pick Your AI Client

Choose ChatGPT, Claude Desktop, Claude Code, Cursor, VS Code, or any MCP-compatible AI tool.

03

Connect & Start Chatting

Add the URL or config snippet for your client, authenticate, and start creating surveys with natural language.

Connect your AI client

ChatGPT uses browser login — no API key needed. Other clients use an API key from your dashboard.

💬

ChatGPT

No API Key Needed
1. Open ChatGPT → Settings → Connected tools
2. Click "Add MCP server"
3. Enter:  https://mcp.survona.com/mcp
4. ChatGPT will open a browser window — sign in to Survona
5. Approve access → done! Start chatting.

ChatGPT uses OAuth 2.0 with browser login — no API key needed. Works with ChatGPT Plus, Team, and Enterprise.

🖥️

Claude Desktop

{
  "mcpServers": {
    "survona": {
      "url": "https://mcp.survona.com/mcp",
      "headers": {
        "X-API-Key": "agt_pub_YOUR_KEY"
      }
    }
  }
}

Save to ~/.config/claude-desktop/config.json (macOS/Linux) or %APPDATA%\Claude\config.json (Windows). Restart Claude Desktop.

⌨️

Claude Code

claude mcp add survona https://mcp.survona.com/mcp \
  --header "X-API-Key: agt_pub_YOUR_KEY"

Run once in your terminal. Verify with: claude mcp list

🎯

Cursor

{
  "servers": {
    "survona": {
      "url": "https://mcp.survona.com/mcp",
      "headers": {
        "X-API-Key": "agt_pub_YOUR_KEY"
      }
    }
  }
}

Save to .cursor/mcp.json in your project, or add in Cursor → Settings → MCP Servers.

💻

VS Code / Copilot

{
  "mcp.servers": {
    "survona": {
      "url": "https://mcp.survona.com/mcp",
      "headers": {
        "X-API-Key": "agt_pub_YOUR_KEY"
      }
    }
  }
}

Add to .vscode/settings.json or your VS Code user settings.json.

🌊

Windsurf

{
  "mcpServers": {
    "survona": {
      "url": "https://mcp.survona.com/mcp",
      "apiKey": "agt_pub_YOUR_KEY"
    }
  }
}

Add to Windsurf MCP config. Replace YOUR_KEY with your Survona API key.

137 tools — here are some highlights

Public API keys give access to core tools. Request researcher or admin access for advanced features.

create_survey

Create a new survey from a natural-language description

e.g. "Create a customer feedback survey with NPS"

list_surveys

List all surveys in your workspace

e.g. "Show me all my surveys"

get_survey

Get full details + blueprint for any survey

e.g. "Show me the NPS survey blueprint"

query_responses

Query response data from any survey

e.g. "Get responses where score < 7"

generate_survey_content

Use AI to generate survey questions & content

e.g. "Generate questions for an employee engagement survey"

get_survey_analytics

Get analytics and insights for survey responses

e.g. "Show me completion rates for my NPS survey"

Need QA testing, evaluation, or admin tools? Request an elevated key →

See it in action

User → Create me a customer feedback survey with NPS and open comments
AI → [calls create_survey] Creating “Customer Feedback Survey”...
AI → Survey created! ID: srv_abc123. Adding questions now...
User → Get the last 10 responses where NPS score is below 7
AI → [calls query_responses] Found 4 responses. 3 mentioned “slow support”, 1 mentioned “pricing”.
User → Show me completion analytics
AI → [calls get_survey_analytics] 87% completion rate, avg 2.3min, 142 total responses this week.

Get help via MCP

Once connected, you can ask your AI client questions about Survona and get instant answers — without leaving your workflow.

You: “Create a 5-question employee engagement survey in Spanish”
AI: Using create_survey to set up the survey, then generate_survey_content for Spanish language questions...

Ready to connect?

ChatGPT users can connect instantly via browser login. Other clients need a free API key.