{
  "markdown": "# Minds MCP Server\n\n[![smithery badge](https://smithery.ai/badge/alexander-a4p3/minds)](https://smithery.ai/servers/alexander-a4p3/minds)\n[![DOI](https://zenodo.org/badge/DOI/10.5281/zenodo.21711429.svg)](https://doi.org/10.5281/zenodo.21711429)\n\nRun AI market research from your assistant: synthetic customer panels for concept\ntesting, message testing, and segment comparison.\n\n**Endpoint:** `https://getminds.ai/mcp` (streamable HTTP)\n**Docs:** https://getminds.ai/mcp/setup\n**Quick-start guide:** https://minds-ai-co.github.io/minds-mcp/\n**Technical reference:** https://minds-mcp.readthedocs.io/en/latest/\n**GitBook:** https://minds-1.gitbook.io/minds-mcp/\n**Client compatibility:** https://minds-mcp-compatibility.pages.dev/\n**Setup generator:** https://minds-mcp-setup-generator.netlify.app/\n**Public API explorer:** https://minds-api-explorer.vercel.app/?utm_source=content&utm_medium=content&utm_campaign=content-seo-mcp-reference&utm_content=mcp-repository-api-explorer\n**API + MCP integration lab:** https://minds-api-mcp-integration-lab-bba685.gitlab.io/?utm_source=content&utm_medium=content&utm_campaign=content-seo-mcp-reference&utm_content=mcp-repository-integration-lab\n**Archived release:** https://doi.org/10.5281/zenodo.21711429\n**Auth:** OAuth 2.1 with PKCE, or a Minds API key\n\n> This repository is documentation for a hosted MCP server. There is no code to\n> install or run. The server is operated by [Minds](https://getminds.ai) and the\n> implementation lives in our application, not here.\n\n## Documentation maintenance\n\n`reference/` is the single source for maintained integration content. Read the\nDocs and GitBook publish the same Markdown through repository sync. GitHub Pages,\nCloudflare Pages, and the Netlify setup generator are intentionally thin,\nplatform-specific surfaces; Zenodo preserves versioned release snapshots. See\n[DOCUMENTATION.md](DOCUMENTATION.md) for the publishing contract.\n\n## What it does\n\n[Minds](https://getminds.ai) is a synthetic market research platform. This MCP\nserver lets ChatGPT, Claude, Cursor, and any other MCP client run customer\nresearch end to end without leaving the assistant.\n\nDescribe an audience in a brief (\"German Gen Z grocery shoppers\", \"enterprise IT\nbuyers in fintech\") and the server runs deep web research to ground that audience\nin government statistics, peer-reviewed studies, and industry reports rather than\nin generic model priors. Then ask the panel a question, run a structured study,\nand export the results.\n\nTypical jobs:\n\n- Concept testing and message testing before creative production\n- Ad pretesting, landing page audits, and packaging tests with per-segment reactions\n- Buyer persona validation and objection discovery for B2B go to market\n- Segment comparison and positioning checks across markets\n- Screening research hypotheses before commissioning fieldwork with real respondents\n\nStudies run durably server side, so a long study survives the chat session that\nstarted it. Results export to PDF, CSV, XLSX, JSON, and Markdown.\n\n**Scope.** Minds does not replace representative human fieldwork. It replaces the\nslow first pass: sharpening the question, surfacing objections, and deciding which\nassumptions deserve real-respondent validation.\n\n## Setup\n\n### ChatGPT\n\nSettings, then Connected Apps, then add `https://getminds.ai/mcp` and authorize via\nOAuth. Panel results render as interactive widgets inline.\n\n### Claude Desktop and claude.ai\n\nCustomize, then Connectors, then add `https://getminds.ai/mcp` as a remote\nconnector and authorize via OAuth.\n\n### Claude Code\n\n```bash\nclaude mcp add --transport http mindsai https://getminds.ai/mcp \\\n  --header \"Authorization: Bearer minds_YOUR_API_KEY\"\n```\n\n### Cursor\n\nSettings, then MCP, then add `https://getminds.ai/mcp` and authorize via OAuth.\nThe repository also contains a Marketplace-ready Cursor plugin manifest at\n`.cursor-plugin/plugin.json`; its MCP configuration is intentionally kept in\n`cursor.mcp.json` so the shared Agent Plugins configuration can retain the\nportable `streamable-http` transport name.\n\n### Google Antigravity\n\n```bash\nagy plugins install https://github.com/minds-ai-co/minds-mcp\n```\n\nThe root `plugin.json` and `mcp_config.json` make this repository an Antigravity\nplugin. Antigravity discovers OAuth from the hosted endpoint and prompts you to\nauthenticate. You can also add Minds directly in the Antigravity MCP manager\nwith the server URL `https://getminds.ai/mcp`.\n\nGemini CLI remains supported for Google Cloud enterprise and API-key users. Its\nlegacy extension manifest stays available as `gemini-extension.json`.\n\n### ChatGPT and Codex Plugins\n\nThe repository includes the shared plugin package at\n`.codex-plugin/plugin.json` and its remote server configuration in `.mcp.json`.\nThe public directory listing uses the same hosted endpoint and maintained\nreference content.\n\n### VS Code (Copilot), Windsurf, Langdock, Open WebUI\n\nAdd `https://getminds.ai/mcp` as a remote MCP server. Full per-client instructions,\nincluding API key setup, are at https://getminds.ai/mcp/setup.\n\n### API keys\n\nGenerate one in the Minds app under Settings, then API Keys. Keys start with\n`minds_` and are passed as `Authorization: Bearer minds_...`.\n\n## Tools\n\n| Tool | What it does |\n|------|--------------|\n| `list_groups` | List your saved Audiences, segments, and persona collections. |\n| `create_group_from_brief` | Build a grounded synthetic Audience from a population brief via deep web research. |\n| `ask_group` | Ask, survey, or poll a single Audience and get per-respondent answers. |\n| `list_panels` | List your panels, studies, surveys, and focus groups. |\n| `create_panel` | Create a panel or study from a research goal. |\n| `ask_panel` | Ask one straightforward question across a whole panel. |\n| `get_panel_status` | Check panel composition and live progress on in-flight questions. |\n| `export_panel` | Export panel results as PDF, CSV, XLSX, or JSON. |\n| `plan_panel_study` | Draft a structured research plan for multi-question studies, asset audits, and MaxDiff. |\n| `run_panel_study` | Execute a confirmed study plan as a durable server-side run. |\n| `get_panel_study` | Check durable progress, artifacts, and method calculations for a running study. |\n| `list_research_methods` | List supported research methods and which of them can actually execute. |\n| `get_panel_summary` | Return a whole-study summary with semantic blocks and heatmaps. |\n| `list_study_drafts` | List reusable study-plan drafts in the connected workspace. |\n| `save_study_draft` | Save a study plan as a reusable draft before execution. |\n\nResearch methods: MaxDiff runs through a deterministic adapter. Conjoint is\nplanned and cannot execute yet. Call `list_research_methods` for the current\nstate rather than assuming.\n\n## Discovery\n\n- Server card: `https://getminds.ai/.well-known/mcp/server-card.json`\n- OAuth protected resource metadata: `https://getminds.ai/.well-known/oauth-protected-resource`\n- Registry name: `ai.getminds/minds`\n\n## Links\n\n- Product: https://getminds.ai\n- MCP setup guide: https://getminds.ai/mcp/setup\n- API docs: https://getminds.ai/api\n- Versioned integration reference: https://doi.org/10.5281/zenodo.21711429\n- Documentation publishing model: DOCUMENTATION.md\n- GitBook reference: https://minds-1.gitbook.io/minds-mcp/\n- Client compatibility: https://minds-mcp-compatibility.pages.dev/\n- MCP setup generator: https://minds-mcp-setup-generator.netlify.app/\n- Public API explorer: https://minds-api-explorer.vercel.app/?utm_source=content&utm_medium=content&utm_campaign=content-seo-mcp-reference&utm_content=mcp-repository-links-api-explorer\n- API + MCP integration lab: https://minds-api-mcp-integration-lab-bba685.gitlab.io/?utm_source=content&utm_medium=content&utm_campaign=content-seo-mcp-reference&utm_content=mcp-repository-links-integration-lab\n- Support: https://getminds.ai\n- Developer portal distribution model: DISTRIBUTION.md\n- Google Antigravity plugin manifest: plugin.json\n- Google Antigravity MCP configuration: mcp_config.json\n",
  "bytes": 8033,
  "sha": "76144329e5d553a47bd0929c41092ee89737499cfc171fcb9a28668b23b82a84",
  "repo_slug": "minds-ai-co/minds-mcp",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_ai_getminds_minds_7f37a836/readme"
}