# Minds: Synthetic Market Research Panels MCP server

Run AI market research: synthetic customer panels for concept testing, message testing, segments.

## Links
- Registry page: https://www.getdrio.com/mcp/ai-getminds-minds
- Repository: https://github.com/minds-ai-co/minds-mcp
- Website: https://getminds.ai/mcp/setup

## Install
- Endpoint: https://getminds.ai/mcp
- Auth: Not captured

## Setup notes
- Remote endpoint: https://getminds.ai/mcp

## Tools
- create_study (Create a Study) - Creates a new Study workspace from existing Audiences or inline Audience configurations; it does not ask questions or run research. Follow-up research in an existing Study does not require another Study. Every questionnaire, survey, battery, section, cohesive question set, or request with two or more known questions belongs in one planned and confirmed multi-question block inside that Study. Never submit such a known set as separate direct questions. A direct question is appropriate only when exactly one standalone question is known or the next question depends on earlier results. Composite creation is atomic and rolls back partial Audience failures. Studies are private by default; enabling link sharing also publishes the attached Audiences and Minds. Endpoint: https://getminds.ai/mcp
- ask_study (Ask One Standalone Question in a Study) - Submits exactly ONE respondent-visible question in an existing Study. Applicability: one standalone question, or one adaptive follow-up whose wording could not be known before earlier results. Exclusion: never use this operation for a questionnaire, survey, battery, section, cohesive question set, or any request containing two or more known questions—even when every question targets the same Study. The complete known set belongs in one planned and confirmed multi-question block inside the Study and must be submitted once, not question by question. Follow-up questions remain within the existing Study; this operation does not create or enumerate Studies. The full question value may reach respondents and is not planner-only metadata. Scale, categorical, and qualitative questions are classified automatically, and the response includes status and workspace links. Automatic classification may reformulate the question; this operation does not promise verbatim wording. Locked respondent wording and response formats require a reviewed and confirmed Study plan. The question is classified before it is queued, so the returned status is authoritative: queued or running means it was submitted to respondents, while planning_required means it was declined as an unrefined research objective and nothing was submitted. A planning_required response carries the original request plus a proposed headline and respondent questions for study planning. MCP cannot read or upload a local file:// path. Use a fetchable HTTP(S) URL, a signed URL supplied by the client for the attached file, or an existing Minds workspace upload URL/path. Study tools import external file URLs into durable Minds storage before saving or running. The Study refuses to start if Minds cannot read the asset. Endpoint: https://getminds.ai/mcp
- export_study (Export Study Results) - Starts an asynchronous export of Study results and returns an export job ID. Supports executive briefs and full reports in PDF, DOCX, PPTX, or Markdown, plus raw data in CSV, XLS, or SPSS SAV. Endpoint: https://getminds.ai/mcp
- export_mind (Export Mind Persona Profile) - Generates a branded profile for one existing Mind, identified by exact ID or fuzzy name. Markdown is returned inline by default; PDF, DOCX, and PPTX artifacts are returned as base64 with a workspace link. Endpoint: https://getminds.ai/mcp
- export_audience (Export Audience Brief) - Exports an Audience brief through the same unified branded renderer used by the web app. Supports Markdown, PDF, DOCX, and PPTX. Binary artifacts are returned as base64. Endpoint: https://getminds.ai/mcp
- export_heatmap (Export Website Heatmap) - Exports a completed website heatmap from a Study result, identified by the message ID reported with the completed result. Returns the same ZIP archive as the web app, including its unified-renderer PDF report, Markdown, images, and metadata. Endpoint: https://getminds.ai/mcp
- list_studies (List Studies) - Lists the authenticated user's Studies with their Audiences, Minds, status, sharing state, and workspace or shared links. Accepts an optional fuzzy name search. A Study is the persistent workspace that contains its Audiences, questions, multi-question blocks, results, exports, and history. Endpoint: https://getminds.ai/mcp
- get_study_status (Get Study Status) - Returns the current Study state, live progress for in-flight questions, completed per-Audience results, linked Minds, Study links, and the status of a specific asynchronous export job when export identifiers are supplied. Values can be numeric answers or classified summary labels; message fields contain the original Mind responses when available. locale is the Study display locale, not a guarantee of the language of every response. Endpoint: https://getminds.ai/mcp
- list_audiences (List Audiences) - Lists the authenticated user's Audiences, including member Minds, sharing state, and workspace or shared links. Accepts an optional fuzzy name search. Endpoint: https://getminds.ai/mcp
- get_audience_limits (Get Audience Limits) - **Call this before creating an Audience whenever a size is in play** — the user named a number, asked for "as many as possible", or you are choosing a creation mode. Returns the ceilings that apply to THIS account: the per-Audience plan cap including any negotiated Enterprise allowance, the custom-size maximum, and per-mode ceilings.

Read the two mode ceilings carefully, they are different things: `automaticSizingCeiling` bounds the size the server picks when you send no memberCount, while `explicitCountCeiling` bounds a size you state. Only "balanced" has the latter — exceed it and creation is refused with MODE_CAP. In the deeper modes a stated size is bounded by `memberCap` alone.

Prefer calling this over guessing: being refused mid-creation is expensive, because the build has already been enqueued by then. Endpoint: https://getminds.ai/mcp
- create_audience_from_brief (Create a Grounded Audience from a Brief) - Creates a grounded Audience of synthetic Minds from a population or audience brief. It can combine authoritative web research, supplied sources, research files, and reviewed spreadsheet distributions; persists provenance and allocation audits; supports balanced, segment-coverage, and benchmark-depth sizing; can individually train every member of a large reviewed-dataset cohort in the background (trainMembers); is idempotent for identical inputs; and keeps the Audience private unless link sharing is enabled. Endpoint: https://getminds.ai/mcp
- ask_audience (Ask One Standalone Audience Question) - Submits exactly one respondent-visible standalone question to one existing Audience, identified by exact ID or fuzzy name. It creates a private Study for that Audience, starts asynchronous responses from its Minds, and returns the Study identifier and links. Automatic classification may reformulate the question; this operation does not promise verbatim wording. Locked respondent wording and response formats require a reviewed and confirmed Study plan. Never use this operation for a questionnaire, battery, section, cohesive question set, or any request with two or more known questions; create a Study and plan the complete multi-question block instead. MCP cannot read or upload a local file:// path. Use a fetchable HTTP(S) URL, a signed URL supplied by the client for the attached file, or an existing Minds workspace upload URL/path. Study tools import external file URLs into durable Minds storage before saving or running. The Study refuses to start if Minds cannot read the asset. Endpoint: https://getminds.ai/mcp
- plan_study_questions (Plan a Multi-Question Block in a Study) - Creates or revises a non-executing draft for a multi-question plan inside an existing Study. Applicability: this is the setup operation for every questionnaire, survey, battery, section, cohesive question set, or request containing two or more known questions—even when the user did not say “study.” Include every question known now in this ONE draft, group related questions into cohesive named modules (question blocks or batteries), preserve their logical order, and execute them later as one confirmed run inside the Study. Never split a known set across one-question drafts or sequential runs. A one-question draft is valid only for genuinely standalone research; an adaptive follow-up whose wording depends on unavailable results can be planned later. The draft records intent, respondent-visible stimulus and questions, response formats, locale, method, outputs, confirmation questions, and revision metadata. It does not start research. When the user supplies a fixed or pre-registered instrument whose wording, order, and response formats must not change, pass it as questions (one entry per item with its exact response contract) instead of request; the planner is then bypassed and the draft is an exact transcription. MCP cannot read or upload a local file:// path. Use a fetchable HTTP(S) URL, a signed URL supplied by the client for the attached file, or an existing Minds workspace upload URL/path. Study tools import external file URLs into durable Minds storage before saving or running. The Study refuses to start if Minds cannot read the asset. Endpoint: https://getminds.ai/mcp
- run_study_questions (Run a Confirmed Multi-Question Block) - Executes the exact stored multi-question draft revision inside the target Study after explicit confirmation. One execution submits the ENTIRE draft—all named modules and all questions—as one durable run. Never execute each known question separately and never create one run per module. This operation is valid only after the person explicitly confirms the exact draft revision. The server reloads and validates the revision, method availability, runner configuration, reviewed capabilities, optional advanced-method consent, and idempotency key before queuing durable research. MCP cannot upload or read a local file:// path: attach the file through the client and use its signed HTTPS URL, upload it to Minds first, or use another fetchable HTTPS URL. Before invoking any Mind or using Study quota, the server verifies that required respondent-visible source material is readable and refuses the entire run if it is not. Endpoint: https://getminds.ai/mcp
- get_study_run (Get Multi-Question Run Status) - Returns durable progress or results for one confirmed multi-question run inside a Study, including its immutable confirmed plan, server-prepared execution plan, respondent-visible question audit, question progress, response artifacts, deterministic method calculations, and stage readiness. Endpoint: https://getminds.ai/mcp
- list_research_methods (List Research Methods) - Lists Minds research methods with availability, complexity, executable status, and fallback metadata. Results distinguish currently executable methods from experimental or planned methods. Endpoint: https://getminds.ai/mcp
- list_study_drafts (List Study Drafts) - Lists durable unfinished study drafts, or returns the complete saved planning state for one exact draft ID. Draft records are distinct from running or completed studies. Endpoint: https://getminds.ai/mcp
- save_study_draft (Save Study Draft) - Creates or checkpoints an unfinished Quick or Custom Study draft without starting research. It saves the objective, context, selected Audiences, method, questions, sources, and current planner step. Revisions require the exact draft ID and expected revision, and stale writes are rejected. Endpoint: https://getminds.ai/mcp
- get_study_summary (Get Study Summary) - Returns or refreshes the semantic summary for a Study as Markdown plus flexible evidence blocks. Website, image, and video analyses retain heatmap-compatible block metadata. Endpoint: https://getminds.ai/mcp

## Resources
- ui://widget/response.html - Study Response Shows Study results with bar diagrams, Audience comparisons, and Mind cycling. MIME type: text/html;profile=mcp-app
- ui://widget/creation.html - Mind Creation Progress Shows real-time training progress when creating a new Mind. MIME type: text/html;profile=mcp-app
- ui://widget/info.html - Mind / Audience Info Shows details about a Mind or Audience, including members and metadata. MIME type: text/html;profile=mcp-app

## Prompts
Not captured

## Metadata
- Owner: ai.getminds
- Version: 2.0.2
- Runtime: Streamable Http
- Transports: HTTP
- License: Not captured
- Language: Not captured
- Stars: Not captured
- Updated: Aug 3, 2026
- Source: https://registry.modelcontextprotocol.io