Koji MCP Integration Overview
Connect Koji to Claude, Cursor, and other AI assistants using the Model Context Protocol (MCP). Manage your entire research workflow conversationally — create studies, run interviews, analyze data, and generate reports without leaving your AI assistant.
What is the Koji MCP Integration?
The Koji MCP integration lets you connect your AI-powered research platform directly to Claude, Cursor, Windsurf, and any AI assistant that supports the Model Context Protocol (MCP). Instead of switching between tabs, you manage your entire qualitative research workflow through natural conversation.
Think of it as giving Claude direct access to your Koji account. You can say things like:
- "Create a new customer discovery study about why users churn after onboarding"
- "Add an NPS question on a 0-10 scale with anchor probing and 3 open-ended follow-ups"
- "Show me the average satisfaction score and top themes from my pricing study"
- "Generate a report from my latest interviews and publish it for my team"
All without leaving your AI assistant.
Why Use MCP Instead of the Dashboard?
The Koji dashboard gives you full visual control. MCP gives you speed and automation. Here is when each makes sense:
| Scenario | Dashboard | MCP via Claude |
|---|---|---|
| Browse studies visually | Best | Good |
| Create a study with structured questions | Good | Best — Claude configures question types, scales, and probing |
| Cross-analyze multiple interviews | Manual | Best — Claude synthesizes patterns |
| Generate and iterate on reports | Good | Best — conversational refinement |
| View per-question aggregations (NPS averages, choice distributions) | Good | Best — instant quantitative summaries |
| Bulk import respondents | Good | Best — natural language input |
| Customize branding in detail | Best | Good |
| Quick status check | Requires login | Best — one question |
The real power is combining Claude's reasoning with your research data. Claude does not just read your data — it can create studies with structured question types (scales, multiple choice, rankings), help you refine interview questions and probing strategies, cross-reference findings across studies, and generate shareable reports.
What Can You Do?
15 Tools Across 5 Categories
The Koji MCP server exposes 15 tools organized into logical groups:
Read and Explore (5 tools)
| Tool | What It Does |
|---|---|
koji_list_studies | List all your studies with status, interview counts, and completion metrics |
koji_get_study | Get full study details including research brief, structured questions, methodology, and interview data |
koji_get_interviews | List interviews with AI-generated summaries, themes, and sentiment |
koji_get_transcript | Read full interview transcripts with per-question structured answers and analysis |
koji_get_account | Check your plan, credit balance, and available features |
Create and Publish (3 tools)
| Tool | What It Does |
|---|---|
koji_create_study | Create a study with structured questions (open-ended, scale, choice, ranking, yes/no) and methodology framework |
koji_update_brief | Modify brief sections, replace questions, change methodology, adjust probing settings |
koji_publish_study | Make a draft study live — sets up AI interviewer, generates interview link |
Analyze and Report (4 tools)
| Tool | What It Does |
|---|---|
koji_get_study_data | Get aggregated data with per-question statistics (scale averages, choice frequencies, ranking positions) |
koji_generate_report | Generate a comprehensive AI research report from interview data |
koji_get_report | Retrieve report sections — executive summary, themes, charts, recommendations |
koji_publish_report | Publish report with a shareable public link for stakeholders |
Customize (1 tool)
| Tool | What It Does |
|---|---|
koji_configure_study | Configure branding, lead forms, interaction modes, URL slug, and Open Graph settings — all in one tool |
Distribute (2 tools)
| Tool | What It Does |
|---|---|
koji_export_data | Export study data as structured JSON for external analysis |
koji_import_respondents | Import contacts with personalized interview URLs for outreach |
Structured Questions via MCP
One of the most powerful MCP capabilities is creating studies with structured question types. Instead of plain open-ended questions, you can configure:
- Scale questions — NPS (0-10), satisfaction (1-5), Likert scales (1-7) with labeled endpoints and anchor probing
- Single and multiple choice — Segment respondents with predefined options and optional "Other" free-text
- Ranking questions — Prioritize features, pain points, or alternatives by asking respondents to rank options
- Yes/No questions — Quick screening or validation checks
- Open-ended questions — Deep qualitative exploration with configurable probing depth (0-3 follow-ups)
The AI interviewer presents these as interactive widgets during the conversation and captures structured data alongside qualitative context. After interviews complete, koji_get_study_data returns per-question aggregations (averages, distributions, frequencies) and koji_get_transcript includes typed structured answers for each question.
Supported AI Assistants
The Koji MCP server works with any client that supports the Model Context Protocol:
- Claude Desktop — Anthropic's desktop app (recommended)
- Claude.ai — Browser-based Claude with MCP support
- Cursor — AI-powered code editor
- Windsurf — AI development environment
- Any MCP-compatible client — The protocol is an open standard
Plan and Credit Information
MCP access is available on all plans. Credits are the only gate for usage:
| Action | Credit Cost |
|---|---|
| Text interview | 1 credit |
| Voice interview | 3 credits |
| Report generation | 5 credits |
All plans include MCP access. Study creation is unlimited on all plans. Voice interviews require the Interviews plan or higher with ElevenLabs integration enabled. See the plan comparison guide for full details.
Security and Privacy
- OAuth 2.1 with PKCE — Industry-standard secure authentication. No API keys stored in config files.
- Scoped access — MCP only accesses your studies, interviews, and account data.
- No training data — Your research data is never used to train AI models.
- Token rotation — Access tokens expire every hour with automatic refresh.
- Revocable — Disconnect any time from your Koji account settings.
Learn more in the Authentication and Security guide.
Next Steps
- Set up the connection — Connect Koji to Claude in under 2 minutes
- Explore the tool reference — Detailed docs for all 15 tools
- Follow a workflow guide — End-to-end examples for your role
- Learn about structured questions — Configure question types, scales, and probing
Further reading on the blog
- Best AI Market Research Tools in 2026: The Complete Buyer's Guide — AI has fundamentally changed market research. This guide compares the leading AI market research platforms—from AI-native interview tools li
- AI-Moderated Interview Platforms Compared: Which One Actually Works? (2026) — Not all AI interview platforms deliver real qualitative depth. This guide compares the top AI-moderated interview platforms in 2026 — Koji,
- Koji vs Remesh: AI Interviews vs AI Focus Groups — Which Research Method Wins? (2026) — Remesh runs AI-powered live focus groups with up to 1,000 participants. Koji runs async AI interviews with zero groupthink. Here is the full
Related Articles
AI Research Agent: How Autonomous AI Conducts User Interviews End-to-End
A practical guide to AI research agents — autonomous systems that design studies, run conversational interviews, and synthesize findings without a human moderator. Includes how Koji's agentic stack works under the hood.
User Research API: Embed AI Interviews into Any Product or Workflow
How to use Koji's User Research API to run AI-moderated interviews from your own backend. Covers REST endpoints, the embed widget, webhooks, authentication, rate limits, and headless interview patterns.
Plan Comparison Guide
Compare Koji's credit-based pricing plans — Free, Insights, Interviews, and Enterprise — to find the right fit for your research needs.
Structured Questions in AI Interviews
Mix quantitative data collection — scales, ratings, multiple choice, ranking — with AI-powered conversational follow-up in a single interview.
Connect Koji to Claude (Setup Guide)
Step-by-step guide to connect your Koji account to Claude Desktop, Claude.ai, Cursor, and other MCP clients. Takes under 2 minutes with OAuth — no API keys required.
MCP Tool Reference
Complete reference for all 17 Koji MCP tools. Includes parameters, return data, plan requirements, and example prompts for each tool across read, create, analyze, customize, and distribute categories.
Connect Koji to Cursor: MCP Setup Guide for Product Engineers
Wire the Koji MCP server into Cursor so the editor can pull live customer interview insights, themes, and quality scores while you ship features. Five-minute setup, fifteen tools.