Two connections. Two ways to work.
Ask Gather. Sign in with your work email.
For conversational research, use https://share.gatherhq.com/api/mcp. Sign in with your work email and the 6-digit code Gather sends you. No workspace yet? Create one for your company as you sign in.
gather_ask scopes studies and launches them after your approval, pulls findings and quotes, chats with personas, and drafts content. The same connector runs research reports.
Help me connect Gather as a buyer-research tool for my GTM work. 1. Use Gather's official connection instructions: https://share.gatherhq.com/mcp 2. Connect the Gather MCP server: https://share.gatherhq.com/api/mcp 3. Guide me through work-email sign-in with the 6-digit code in the official Gather connection flow. Do not ask me to paste passwords, email codes or access tokens into chat. If my company has no Gather workspace yet, I can create one during sign-in. If my enterprise workspace needs admin approval, give me the exact server URL and setup steps to share with the admin. 4. Discover the available tools. Gather's tools are gather_ask (Ask Gather), gather_report_start, gather_report_check and gather_report_list; use the tool schemas returned by the server instead of guessing parameters. 5. Ask for my brand, target buyers and the GTM decision I need to make. Distinguish existing research, simulated estimates and new interviews. 6. Start by asking Gather to scope the question. Show me the proposed research plan before launching any study or paid work. Return the findings, key implications and a report link when available. First task: Help me understand which message our target buyers care about most, what would make them switch, and how we should change our positioning. Ask me for the company and ICP first. If this agent cannot configure MCP, walk me through the supported connection steps. Do not claim Gather is connected until the authenticated tool connection succeeds.
Download the setup instructions or open Gather’s connection guide.
Configure the connection.
Add the server URL in Claude or ChatGPT connector settings. Using Cursor or VS Code? Add to Cursor ↗ Add to VS Code ↗
Discover the tool schema from the authenticated server. Ask Gather to scope your brand, audience, and decision, then show you the plan before launching a study. Your organization may need an admin to approve connectors.
Run a research report. Sign in or use a key.
For custom agents and workflows, connect to https://synthetic.gatherhq.com/api/v1/mcp using Streamable HTTP. Sign in with your work email, or authenticate with the same key used for the report API.
https://synthetic.gatherhq.com/api/v1/mcp
Authorization: Bearer <key>
# Or use: x-api-key: <key>Prefer a header when your client supports it. For clients that accept only a URL, use:
https://synthetic.gatherhq.com/api/v1/mcp?gatherApiKey=<key>Treat the complete keyed URL as a secret. Do not put it in shared setup files or public repositories. Query-string keys are supported on this MCP connection, not on REST report endpoints.
Start. Check. List.
| Tool | What it does | Input |
|---|---|---|
gather_report_start | Start a report and return its ID. | The report request fields, plus optional idempotency_key. |
gather_report_check | Check status and retrieve the completed report. | id |
gather_report_list | List reports for this key, newest first. | Optional limit, 1 to 25. Default 10. |
The start tool accepts company, question, website, audience, audience_type, key_questions, and respondents. See the request fields and limits.
A report researches the company, designs the interview guide, and runs 30 simulated interviews, configurable from 10 to 50, with your audience on Gather’s research platform in your own workspace. It returns a branded report link plus findings, themes, and quotes.
Give the report time to finish.
Keep the returned report ID. Call gather_report_check every 30 to 60 seconds until completed or failed. Reports take about 16 minutes, or about 10 with 10 interviews. Each key allows 3 reports running at once, plus its daily limit.
A completed response includes:
report_url: the branded report link.output:headline,summary,answer,key_findings,options,priorities,points,next_steps,themes,quotes,unknowns, andvalidation_test.study.app_url: the study in your Gather workspace.methodology: how to interpret the report.confidence:"directional".
Results are simulated and directional. They are not a survey of real people.
Read the REST quickstart for request validation, status handling, retries, and errors.