Minds MCP Server
OfficialCloudflare Pages is used as a thin, platform-specific publishing surface for the Minds MCP documentation reference content.
GitBook hosts the Minds MCP technical reference documentation for the server.
GitHub Pages is used as a thin, platform-specific publishing surface for the Minds MCP documentation reference content.
Minds is the platform itself—this MCP server runs synthetic market research panels for concept testing, message testing, and segment comparison, with tools to create audiences, run surveys and studies, and export results.
Netlify is used to host the Minds MCP setup generator, providing a platform-specific web surface for generating client setup configurations.
Zenodo preserves versioned release snapshots of the Minds MCP documentation and integration reference.
This server has a remotely hosted endpoint. Open its connector listing for connection details, authentication requirements, and setup instructions:
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.
Related MCP server: Sablier MCP Server
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-mcpThe 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 45 tools. Clients read the current schemas at runtime; the full list with access levels is in reference/tools.md.
Tool | What it does |
| Lists the authenticated user's Audiences, most recently updated first, one page at a time (limit, default 20, and offset; nextOffset continues), with Mind counts, sharing state, and links. |
| Imports supplied UTF-8 text, Markdown, CSV and JSON research files into account-owned storage. |
| Researches a free-text population brief and builds a new Audience of Minds with explicit profiles and exact segment allocation. |
| Reads progress and never starts or retries anything: an Audience creation by operationId, with its members’ training; or an existing Audience by audienceId, with its member training and background research, or with recalibrationId one recalibration’s status, retained result or terminal error. |
| Shows source research, distributions, proposed Minds, the draft and training for one or more Audience operations, display only: the user confirms or asks for changes in chat. |
| Returns the authenticated account's current plan ( |
| Asks exactly one standalone question of one existing Audience. |
| Exports an Audience brief, or with kind "validation_report" the report of its validations (overall score calculation, every KPI, per-question answer shares, provenance), through the same renderer used by the web app. |
| Permanently copy an Audience with independent copies of its Minds and all they know. |
| Changes an existing Audience in place: it keeps its id, its Minds keep theirs (except copies below), and no Mind is deleted. |
| Manage owner-issued, expiring staff access to one Audience’s composition and receipts. |
| Lists the authenticated user's Studies, most recently updated first, one page at a time: limit (default 20) and offset, with nextOffset to continue. |
| Creates a Study workspace from existing Audiences or inline Audience configurations. |
| Submits exactly one respondent-visible question: one standalone question, or one adaptive follow-up whose wording could not be known before earlier results. |
| Returns Study progress, per-Audience results, original Mind responses, links and export status. |
| Shows the results of finished questions (summary, key findings, Audience breakdowns, Mind responses): one question, or a run's finished questions while the rest still run. |
| Starts an asynchronous export of Study results and returns an export job ID. |
| Permanently copy a Study with its questions and results over the same Audiences. |
| Exports a completed website heatmap from a Study result, identified by the message ID reported with the completed result. |
| Reads saved heatmaps of an assigned question asset. |
| Starts attention analysis of an assigned image, video or website. |
| Generates a branded profile for one existing Mind, identified by exact ID or name (partial names and typos resolve to the closest). |
| Read shared Mind sources and assessments. |
| Creates a non-executing draft in an existing Study with its Audiences already attached. |
| Revises one saved draft at its current draft.id and draft.revision without starting research. |
| Reads the latest saved revision and full review of one draft. |
| Adds existing accessible Audiences without removing others, planning or starting research. |
| Shows a saved Study draft at its current revision for interactive review and confirmation. |
| Runs one reviewed draft revision after explicit confirmation in a later user turn; skipping review is not confirmation. |
| Resumes an existing plan-limited Study run in place after explicit user approval and the required paid-plan entitlement. |
| Stops one standalone Study question by runId, or studyId and questionId: queued or preparing stops at once, being answered stops at its next step. |
| Renames a Study or Audience or moves it into a folder. |
| Turns a Study's or Audience's public link or team sharing on or off. |
| Reads the fixed Minds research-method catalog in one operation, including availability, complexity and fallback method. |
| Lists a page of unfinished Study draft summaries, newest first, or returns the complete saved planning state for one exact draft ID. |
| Lists your own and team-shared Study templates, most used first, as a page of summaries (templateId, name, revision, method, question count), or returns one exact templateId with its revision, research method, questions, response settings and question attachments. |
| Creates or checkpoints an unfinished Quick or Custom Study draft without starting research. |
| Creates a private Custom template with its questions, response settings, attachments and method. |
| Updates one owned Custom template at update.expectedRevision. |
| Creates an independent editable Study draft from a readable template at use.expectedRevision. |
| Only for saved Study templates; it cannot delete Studies, Audiences, Minds or answers. |
| Reads saved whole-Study Markdown, evidence blocks and metadata. |
| Generates and saves a whole-Study summary after explicit approval. |
| Deprecated alias of create_study_plan and revise_study_plan; identical behaviour. |
| Deprecated alias of start_study_run; identical behaviour. |
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.jsonOAuth protected resource metadata:
https://getminds.ai/.well-known/oauth-protected-resource/mcpRegistry 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
This server cannot be deployed
Maintenance
Related MCP Connectors
MCP server for building and testing AI agents with multi-model experimentation and insights.
AI research on companies and industries — one MCP tool per research domain.
Test ideas, messages and ads with Human Digital Twins built from real people, in your AI assistant.
AI-native market research: research studies, persona audience studies, analysis, reports and media
Related MCP Servers
- AlicenseAqualityDmaintenanceEnables running Simulatte's 26 research SKUs (concept testing, pricing, etc.) from any MCP-compatible AI client, returning structured JSON results.747 npmMIT

Sablier MCP Serverofficial
AlicenseAqualityDmaintenanceAn MCP server that lets AI assistants analyze portfolios, stress-test scenarios, generate synthetic market paths, and scan SEC filings — in under 2 minutes.833MIT- AlicenseBqualityDmaintenanceA standalone MCP server that brings complete data science capabilities to AI assistants, enabling them to load data, train models, and track experiments through natural language.301MIT
- FlicenseNot gradedqualityDmaintenanceAI research on companies and industries — one MCP tool per research domain.-