Gather

Documentation · Model Context Protocol

Run Gather research from Claude and ChatGPT

Ask a business question in Claude or ChatGPT. Gather researches the company, designs an interview guide, runs simulated interviews with your target audience on Gather's research platform, and writes a branded report you can share.

Server URL

https://synthetic.gatherhq.com/api/v1/mcp

What you get

  • A report link right away. It shows live progress, then the finished report.
  • A branded report: the headline answer, key findings, which option your audience chose, themes in their own words, quotes, and what to test next.
  • An email with the report when it is ready.
  • The full study as a project in your Gather workspace, with every interview.

Reports with 10 interviews take about 10 minutes; reports with 30 interviews (the default) take about 16 minutes.

Connect in Claude

  1. Go to Customize > Connectors, click + Add, then Add custom connector.
  2. Name it Gather, enter the server URL above, and click Continue.
  3. Under Authentication choose Sign in now, then click Add.
  4. Sign in with your work email, enter the 6-digit code Gather emails you, choose your workspace, and click Allow access.

On Team and Enterprise plans, an Owner first adds the connector under Organization settings > Connectors (Add, then Custom, then Web). Members then click Connect next to it under Customize > Connectors.

Connect in ChatGPT

  1. Turn on developer mode: Settings > Apps > Advanced settings > Developer mode (Plus, Pro, Business, Enterprise and Education on the web).
  2. Click Create app, enter the server URL above, and choose OAuth.
  3. Sign in with your work email, enter the code, choose your workspace, and click Allow access.
  4. In a chat, choose Developer Mode from the + menu and select the Gather app.

Connect in Cursor

Add Gather to ~/.cursor/mcp.json (or .cursor/mcp.json in a project):

{ "mcpServers": { "gather": { "url": "https://synthetic.gatherhq.com/api/v1/mcp" } } }

When Cursor asks you to sign in to Gather, sign in with your work email, enter the code, choose your workspace, and click Allow access.

Connect in VS Code

  1. Open the Command Palette and run MCP: Add Server.
  2. Choose HTTP (HTTP or Server-Sent Events), enter the server URL above, and name it gather.
  3. When VS Code asks you to sign in, sign in with your work email, enter the code, choose your workspace, and click Allow access.

Try it

Name the company and the decision. Add the audience if you know it.

Use Gather to research what would make B2B CMOs switch from survey tools to AI-moderated interviews. The company is Acme (acme.com).
Use Gather to find out what would make new customers of Northwind Coffee start a subscription. Run 10 interviews.

Tools

gather_report_start · Write

Starts a research report and returns its id and report link at once.

Inputs: company and question (required); website, audience, audience_type (b2b or b2c), key_questions (up to 6), respondents (10 to 50, default 30)

gather_report_check · Read only

Returns progress, and when the report is done: headline, findings, option choice, themes, quotes and the report link.

Inputs: id

gather_report_list · Read only

Lists the reports you started this way, newest first, with their links.

Inputs: limit (1 to 25, optional)

Accounts, workspaces and limits

  • You sign in with your work email and choose one of your Gather workspaces.
  • Reports run in that workspace as you, and each one adds a project there.
  • Each person can start up to 10 reports per workspace per day.
  • Disconnect Gather in your app at any time.

For developers

Agents can use a Gather API key instead of signing in. Workspace admins create keys in Gather under Settings > API keys. Send the key to the same server URL:

Authorization: Bearer gk_live_...

For a client that only takes a URL, add the key to it: https://synthetic.gatherhq.com/api/v1/mcp?gatherApiKey=gk_live_.... Anyone with that URL can use the key, so keep it private.

Data and privacy

Gather receives the inputs your assistant sends to these tools, your sign-in email and the workspace you choose. It does not receive your conversation. Sign-in codes and tokens are stored only as secure hashes. See the privacy policy and terms of service. Questions: hi@gobeheard.com.

Support

Email mayank@gatherhq.com for help with sign-in, workspaces or a report. If it is about a report, include its link or id (it starts with rpt_).

Questions

Are these real interviews?

No. Respondents are simulated with AI to match the audience you describe, and they answer an adaptive interview guide on Gather's research platform. Results are directional: use them to sharpen a decision or decide what to test with real people, not as a survey of a market.

How long does a report take?

Reports with 10 interviews take about 10 minutes; reports with 30 interviews (the default) take about 16 minutes. You get a report link right away that shows live progress, and Gather emails you when the report is ready.

Do I need a Gather account?

Yes. You sign in with your work email, and you need to be a member of a Gather workspace. If you are not, ask your Gather admin to invite you, or get started at gatherhq.com.

Who can see my reports?

Reports run in the Gather workspace you choose, as you, and appear there as projects that workspace members can open. The report page itself is a private, unguessable link that is not indexed by search engines; anyone you share the link with can read it.

How do I disconnect?

Remove or disconnect Gather in your app's connector or MCP settings (Claude, ChatGPT, Cursor or VS Code). The assistant can no longer start or read reports, and your reports stay in your Gather workspace.