Great Question MCP

Great Question’s MCP (Model Context Protocol) server gives your team read and write access to studies, sessions, transcripts, highlights, insights, participant data, and study management from Claude Desktop, Claude Code, Cursor, ChatGPT, or any MCP-compatible AI tool.

What's available

The MCP provides access across the full research workflow:

• Candidates: Create, update, and delete participant profiles. View full profiles with demographics and participation history. Search by name, email, study, or date.
• Study design: Create, update, and delete interview studies, survey studies, and unmoderated test studies. Build and manage screener questionnaires with qualification rules, disqualification rules, and skip logic.
• Scheduling: Configure interview booking limits, livestream settings, and scheduling notice. Add, update, and remove moderators, collaborators, and observers.
• Recruitment: Shortlist existing candidates directly onto a study, or send screener invitations to qualify them first. Works across interview, survey, and unmoderated test studies.
• Analysis: Browse and search sessions, transcripts, highlights, and participant responses (screener responses for interviews; survey and test submissions for surveys and unmoderated tests). Access speaker-attributed transcripts and full-text search across transcript content.
• Synthesis: Browse and search insights, research findings, and curated highlight reels across studies.

Setup

All clients connect to the same server URL:

https://greatquestion.co/api/mcp/v1

You'll need an active Great Question account with MCP access enabled. The connection uses OAuth 2.1 — you'll authenticate through your browser with your existing GQ credentials. No API keys or secrets to manage.

Claude Desktop

1. Open Settings → Connectors → Add custom connector.
2. Enter the name Great Question and the server URL above.
3. Click Save, then Connect. Authenticate via your browser.
4. Restart Claude Desktop. GQ tools will appear when you start a new chat.

Claude Code

Run in your terminal:

claude mcp add --transport http GreatQuestion https://greatquestion.co/api/mcp/v1

ChatGPT

1. Go to Settings → Apps → Advanced settings and toggle Developer mode on.
2. Click Create app and enter:
   • Name: Great Question
   • Description: Query GQ Research data
   • MCP Server URL: https://greatquestion.co/api/mcp/v1
   • Authentication: OAuth
3. Check "I understand and want to continue," click Create, and authenticate via your browser.

Cursor

1. Open Cursor Settings (Cmd/Ctrl + Shift + J), then select MCP from the sidebar.
2. Click + New MCP Server to open your mcp.json file.
3. Add the following:

{
  "mcpServers": {
    "great-question": {
      "url": "https://greatquestion.co/api/mcp/v1"
    }
  }
}

1. Save the file, then click Connect on the settings page. Authenticate via your browser.

Verifying your connection

Once connected, run through these quick checks in your MCP client:

1. See your studies. Ask for your recent studies. You should see titles, statuses, and IDs you recognize.
2. Find participants. Ask for candidates in one of those studies. Names and emails should appear as expected.
3. Pull a transcript. Ask for transcripts from that study, then request the full content of one. Look for speaker labels and timestamps.
4. Connect the dots. Pick a participant and ask which studies they've appeared in, what sessions they had, and what their transcripts say.
5. Try a write action. Create a test candidate or draft study to confirm write access is working. You can delete it afterward.
6. Try a repo session. Ask for recent repo sessions, pick one, and request its transcript.

If something doesn't work, see Troubleshooting below.

Available tool calls

The MCP exposes the following tools, organized by research workflow stage. Write tools can create, update, and delete resources. Read tools retrieve and search data.

Candidate tools

Study tools (all types)

These tools work across all study types (interviews, surveys, and unmoderated tests).

Interview study tools

Study management

Screeners

Survey study tools

Study management

Screeners

Unmoderated test study tools

Study management

Screeners

Scheduling tools

Interview calendar

Interview moderators

Participant tools

Tools for adding candidates to a study. Shortlisting adds existing candidates to the study's participant list; sending a screener invitation emails them to fill out the study's screener. You can combine them (shortlist candidates first, then optionally send them a screener to qualify) or use either on its own.

Shortlist existing candidates. Each call automatically skips candidates who are already on the study, inaccessible to your team, uncontactable, or ineligible.

Send a screener invitation. Email candidates a link to fill out the study's screener. Works whether or not they've already been shortlisted.

Session & Transcript tools

Response tools

Access participant responses across all three study types. What a "response" contains depends on the study type:

• Interview studies: screener responses — the candidate's answers to the screener questions, with qualification status and match score. The interview session itself is accessed via the Session & Transcript tools.
• Survey studies: the full survey submission — the participant's answers to the survey questions.
• Unmoderated test studies: the full test submission — answers, task metrics, and timings from the recorded session. The session recording transcript is accessed via get_unmoderated_test_study_response_transcript.

Artifact tools (Highlights, Insights & Reels)

Common tool call parameters

Most list and search tools support these options:

• Pagination: page (default 1), items (default 20, max 100), cursor for continued pagination
• Sorting: orderBy — sort by createdAt or updatedAt (default)
• Date filtering: Exact time windows or relative durations

Use cases

Prep for a stakeholder readout

Pull recent studies, surface key highlights and insights, and get transcript excerpts, all without leaving your AI tool. Ask something like: "Summarize the top findings from our onboarding study and pull the strongest supporting quotes from transcripts."

Set up a study from scratch

Create an interview or survey study, add screener questions with qualification logic and skip branching, assign moderators, configure the interview calendar, and send invitations to candidates — all through natural language prompts. Ask: “Create a new interview study about onboarding, add a 5-question screener with skip logic, and invite our enterprise candidates.”

Catch up on research you missed

Search across studies and transcripts to quickly get up to speed. Try: "What studies have been completed in the last month? Give me a summary of each."

Find patterns across participants

Chain candidate lookups with transcript searches to spot themes. Example: "Which participants mentioned pricing concerns? What studies were they in, and what exactly did they say?"

Pull supporting evidence for a product decision

Search highlights and insights to build a case grounded in research. Ask: "Find all highlights related to navigation issues and summarize the common themes."

Review Screener Responses

Pull screener responses across studies to see how candidates qualified. Try: “Show me all screener responses for our pricing study. How many were qualified vs. disqualified, and what were the common disqualification reasons?”

Audit participant coverage

Check which candidates have been contacted, how often, and across which studies. Try: "Show me all studies that participant Jane Doe has been involved in and their outcomes."

Manage your research panel

Create and update candidate profiles, manage custom attributes, and ensure GDPR compliance with delete capabilities. Ask: “Update the department attribute for all candidates from the Q1 onboarding study to ‘Product.’

Troubleshooting

OAuth window doesn't appear: Make sure your browser allows popups from your MCP client. Some browsers block the OAuth redirect by default.

Tools not showing up: Restart your MCP client after saving the configuration. If tools still don't appear, confirm with your GQ account team that your user has the feature enabled.

Permission errors: The MCP respects your existing GQ access controls. If you can't see certain studies or sessions, check your permissions in the GQ product.

Usage Tips

1. Start broad, then narrow: use list tools first, then search with specific filters.
2. Chain queries: get a study ID, then find its candidates, then retrieve their transcripts.
3. Use full-text search: most search tools support searching within titles, descriptions, and content.
4. Leverage pagination: for large result sets, use pagination to process data in batches.
5. Combine filters: most search tools accept multiple filters for precise results.
6. Let the AI chain writes: describe what you want end-to-end (e.g., “set up a study with a screener and invite these candidates”) and let your AI tool handle the individual tool calls.

Security & data handling

For full privacy details, see our Privacy Policy

Still need help?

Reach out to us anytime in the app or email us at [email protected]!