Minds MCP Server
Run AI market research from your assistant: build synthetic Audiences and run Studies for concept testing, message testing, and segment comparison.
Endpoint: https://getminds.ai/mcp (streamable HTTP)
Docs: https://getminds.ai/mcp/setup
Quick-start guide: https://minds-ai-co.github.io/minds-mcp/
Technical reference: https://minds-mcp.readthedocs.io/en/latest/
GitBook: https://minds-1.gitbook.io/minds-mcp/
Client compatibility: https://minds-mcp-compatibility.pages.dev/
Setup generator: https://minds-mcp-setup-generator.netlify.app/
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
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
Archived release: https://doi.org/10.5281/zenodo.21711429
Auth: OAuth 2.1 with PKCE (dynamic client registration or Client ID Metadata Documents), or a Minds API key (Authorization: Bearer minds_…)
This repository is documentation for a hosted MCP server. There is no code to install or run. The server is operated by Minds and the implementation lives in our application, not here.
Documentation maintenance
reference/ is the single source for maintained integration content. Read the
Docs and GitBook publish the same Markdown through repository sync. GitHub Pages,
Cloudflare Pages, and the Netlify setup generator are intentionally thin,
platform-specific surfaces; Zenodo preserves versioned release snapshots. See
DOCUMENTATION.md for the publishing contract.
What it does
Minds is a synthetic market research platform. This MCP server lets ChatGPT, Claude, Cursor, and any other MCP client run customer research end to end without leaving the assistant.
Describe an audience in a brief ("German Gen Z grocery shoppers", "enterprise IT buyers in fintech") and the server runs deep web research to ground that audience in government statistics, peer-reviewed studies, and industry reports rather than in generic model priors. Then ask the Audience a question, run a structured Study, and export the results.
Typical jobs:
- Concept testing and message testing before creative production
- Ad pretesting, landing page audits, and packaging tests with per-segment reactions
- Buyer persona validation and objection discovery for B2B go to market
- Segment comparison and positioning checks across markets
- Screening research hypotheses before commissioning fieldwork with real respondents
Studies run durably server side, so a long study survives the chat session that started it. Results export to PDF, DOCX, PPTX, Markdown, CSV, XLS, and SPSS SAV.
Scope. Minds does not replace representative human fieldwork. It replaces the slow first pass: sharpening the question, surfacing objections, and deciding which assumptions deserve real-respondent validation.
Setup
ChatGPT
Enable developer mode under Settings → Security and login, then open
Plugins and select the plus button. Add https://getminds.ai/mcp as a public
HTTPS connection, choose OAuth, and sign in to Minds. Availability depends on
your account and workspace policy.
Study results can render as interactive widgets inline. See the official OpenAI connection guide and the Minds setup guide.
Claude Desktop and claude.ai
Customize, then Connectors, then add https://getminds.ai/mcp as a remote
connector and authorize via OAuth.
Claude Code
claude mcp add --transport http mindsai https://getminds.ai/mcp \
--header "Authorization: Bearer minds_YOUR_API_KEY"
Cursor
Settings, then MCP, then add https://getminds.ai/mcp and authorize via OAuth.
The repository also contains a Marketplace-ready Cursor plugin manifest at
.cursor-plugin/plugin.json; its MCP configuration is intentionally kept in
cursor.mcp.json so the shared Agent Plugins configuration can retain the
portable streamable-http transport name.
Google Antigravity
agy plugins install https://github.com/minds-ai-co/minds-mcp
The root plugin.json and mcp_config.json make this repository an Antigravity
plugin. Antigravity discovers OAuth from the hosted endpoint; authenticate under
Settings, then Customizations. To add only the server, run
agy mcp add --type http minds https://getminds.ai/mcp or put
{"mcpServers": {"minds": {"serverUrl": "https://getminds.ai/mcp"}}} in
~/.gemini/config/mcp_config.json. Full guide:
https://getminds.ai/guide/integration-antigravity
Gemini CLI remains supported for Google Cloud enterprise and API-key users. Its
legacy extension manifest stays available as gemini-extension.json.
ChatGPT and Codex Plugins
The repository includes the shared plugin package at
.codex-plugin/plugin.json and its remote server configuration in .mcp.json.
The public directory listing uses the same hosted endpoint and maintained
reference content.
VS Code (Copilot), Windsurf, Langdock, Open WebUI
Add https://getminds.ai/mcp as a remote MCP server. Full per-client instructions,
including API key setup, are at https://getminds.ai/mcp/setup.
API keys
Generate one in the Minds app under Settings → API Keys. Keys start with
minds_ and are passed as Authorization: Bearer minds_....
Tools
The server advertises 32 tools. Clients read the current schemas at runtime; the full list with access levels is in reference/tools.md.
Server card: https://getminds.ai/.well-known/mcp/server-card.json (minds-ai).
Call list_research_methods for current executable status, requirements, and
fallbacks before choosing a research method.
Discovery
- Server card:
https://getminds.ai/.well-known/mcp/server-card.json - OAuth protected resource metadata:
https://getminds.ai/.well-known/oauth-protected-resource/mcp - Registry name:
ai.getminds/minds
Links
- Product: https://getminds.ai
- MCP setup guide: https://getminds.ai/mcp/setup
- API docs: https://getminds.ai/api
- Versioned integration reference: https://doi.org/10.5281/zenodo.21711429
- Documentation publishing model: DOCUMENTATION.md
- GitBook reference: https://minds-1.gitbook.io/minds-mcp/
- Client compatibility: https://minds-mcp-compatibility.pages.dev/
- MCP setup generator: https://minds-mcp-setup-generator.netlify.app/
- 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
- 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
- Support: https://getminds.ai
- Developer portal distribution model: DISTRIBUTION.md
- Google Antigravity plugin manifest: plugin.json
- Google Antigravity MCP configuration: mcp_config.json
