Cookiy MCP Server for Claude

Overview

Cookiy provides a workflow-aware Model Context Protocol server for AI-moderated user research. Agents create studies, run simulated or live interviews, edit discussion guides, recruit participants, generate insight reports, and optionally launch quantitative surveys through official cookiy_* MCP tools.

The production endpoint is https://s-api.cookiy.ai/mcp, registered as ai.cookiy/cookiy. Installation assets live in cookiy-ai/cookiy-skill with the cookiy-mcp bootstrap CLI.

Features

• Study creation and listing through structured MCP tools.
• AI-moderated interviews with guide editing workflows.
• Participant recruitment and billing-aware checkout tools.
• Report generation, sharing, and balance inspection.
• OAuth 2.1 authentication with resumable headless flows for some clients.
• One-command installer that adds both local skill copies and MCP config.

Use Cases

• Spin up a concept-testing study from a product brief in Claude Code.
• Run simulated interviews before spending recruitment credits.
• Recruit participants matching a screening questionnaire.
• Check account balance before launching a paid study wave.
• Generate and share an insight report link with stakeholders.

Installation

Recommended bootstrap CLI

npx cookiy-mcp --client claudeCode -y

Supported --client values include claudeCode, cursor, vscode, codex, windsurf, cline, openclaw, and manus.

Manual HTTP connector

{
  "mcpServers": {
    "cookiy": {
      "url": "https://s-api.cookiy.ai/mcp",
      "type": "http"
    }
  }
}

OAuth discovery is at https://s-api.cookiy.ai/.well-known/oauth-authorization-server.

Verify connection

After install, ask the agent to call cookiy_introduce to confirm authentication and tool access.

Configuration

{
  "mcpServers": {
    "cookiy": {
      "url": "https://s-api.cookiy.ai/mcp",
      "type": "http"
    }
  }
}

Examples

Create a study

Create a Cookiy study to test onboarding confusion for our mobile banking app.

Run simulated interviews

Run three AI-moderated interviews using the current discussion guide and summarize top friction points.

Recruitment

Recruit five participants who match our screening criteria for a 30-minute remote session.

Security

• Confirm credit costs with cookiy_balance_get before paid recruitment or checkout tools.
• Review discussion guides and consent language before contacting real participants.
• Revoke Cookiy OAuth access when offboarding contractors with MCP access.

Troubleshooting

OAuth fails on first connect

Allow network egress to s-api.cookiy.ai and complete the browser or headless OAuth flow your host requires.

Installer did not detect client

Pass --client explicitly, for example npx cookiy-mcp --client cursor -y.

Tool contract errors

Use documented cookiy_* tools only; Cookiy is not a raw REST passthrough.

Claude Cowork network blocks

Enable outbound network access and allow s-api.cookiy.ai in the domain allowlist.