PopsicleAI MCP Server

MCP server for PopsicleAI. Enables AI assistants to create studies, manage recordings, and analyze research data.

Setup

1. Get your API Key

1. Log in to PopsicleAI
2. Click Settings in the header
3. Under API Keys, click Create Key
4. Copy the key — you won't be able to see it again

2. Add to your AI assistant

Claude Code

{
  "mcpServers": {
    "popsicle-ai": {
      "command": "npx",
      "args": ["-y", "popsicle-ai-mcp"],
      "env": {
        "AI_RESEARCHER_API_KEY": "ak_your_key_here"
      }
    }
  }
}

Claude Desktop

Add to ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "popsicle-ai": {
      "command": "npx",
      "args": ["-y", "popsicle-ai-mcp"],
      "env": {
        "AI_RESEARCHER_API_KEY": "ak_your_key_here"
      }
    }
  }
}

Cursor

Add to your Cursor MCP settings:

{
  "mcpServers": {
    "popsicle-ai": {
      "command": "npx",
      "args": ["-y", "popsicle-ai-mcp"],
      "env": {
        "AI_RESEARCHER_API_KEY": "ak_your_key_here"
      }
    }
  }
}

Tools

| Tool | Description | |------|-------------| | list_studies | List your research studies | | get_study | Get study details + recording count | | create_study | Create a new research study | | update_study | Update study configuration | | delete_study | Delete a study and its recordings | | get_participant_link | Get the shareable participant join URL | | list_recordings | List recordings for a study | | get_recording | Get full recording details including transcript | | delete_recording | Delete a specific recording | | get_study_transcripts | Get all transcripts from a study for analysis | | get_study_summary | Get high-level stats (session count, avg duration, etc.) |

Example Usage

Once connected, you can ask Claude things like:

• "List all my research studies"
• "Create a new usability study about our checkout flow"
• "Show me the transcripts from study X and identify key themes"
• "How many participants have completed the onboarding study?"
• "Get the participant link for my latest study"

Environment Variables

| Variable | Required | Default | Description | |----------|----------|---------|-------------| | AI_RESEARCHER_API_KEY | Yes | — | Your API key (starts with ak_) | | AI_RESEARCHER_URL | No | https://popsicleai.app | Override API URL (for development) |