Minds: Synthetic Market Research Panels

ai.getmindsPublished by getminds.aiOfficial publisherv2.0.2Updated Nov 3, 2026

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

VerifiedStreamable HTTPWeb executableData & AnalyticsBusiness & Commerce

Overview

AI-generated overview

Hosted Minds MCP server that lets an assistant build synthetic research audiences and run market research studies, then export the results.

What you can do
  • Create and manage Audiences: build one from a free-text population brief, import research files, list, duplicate, recalibrate and export them
  • Ask questions and run Studies: pose standalone or follow-up questions, check status, render results, cancel questions, and resume runs
  • Plan and review: save, revise and review study drafts and plans, attach audiences, and start a run after confirmation
  • Templates and methods: list research methods, save, update, use and delete study templates
  • Export and share: export studies, heatmaps and Mind profiles, read study summaries, rename or move items, and toggle sharing
When to use it
Useful for early-stage market research before real fieldwork: concept and message testing, ad or landing page pretesting, buyer persona validation, segment comparison, and screening hypotheses. It suits teams already using Minds who want to run that work from ChatGPT, Claude, Cursor or another MCP client.
Requirements
A remote streamable HTTP endpoint at getminds.ai; nothing to install locally. Authentication is required: OAuth 2.1 with PKCE, or a Minds API key passed as an Authorization Bearer header. A Minds account with a plan is needed, and some runs require a paid-plan entitlement.
Before you install
It acts on your Minds account: tools can create, duplicate, recalibrate and permanently copy audiences and studies, change sharing and public links, and delete saved study templates. Studies consume synthetic responses and some runs need a paid-plan entitlement, so check plan limits before starting. API keys are account credentials and should be kept private. Results are synthetic and do not replace representative human fieldwork.

Installation

In SourceWeft

  1. Open Minds: Synthetic Market Research Panels in the dashboard and add it to a workspace.
  2. Connect the required credentials. They are stored privately and never shown on public pages.
  3. Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Use with an agent

Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.

Read https://sourceweft.com/mcp/ai.getminds%2Fminds/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config. The client completes OAuth sign-in on first connect.

{
  "mcpServers": {
    "minds-synthetic-market-research-panels": {
      "type": "http",
      "url": "https://getminds.ai/mcp"
    }
  }
}

README

Minds MCP Server

[smithery badge] [DOI]

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

bash
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

bash
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 45 tools. Clients read the current schemas at runtime; the full list with access levels is in reference/tools.md.

ToolWhat it does
list_audiencesLists 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.
import_audience_sourcesImports supplied UTF-8 text, Markdown, CSV and JSON research files into account-owned storage.
create_audience_from_briefResearches a free-text population brief and builds a new Audience of Minds with explicit profiles and exact segment allocation.
get_audience_creation_progressRead-only; never starts or retries work.
render_audience_reviewShows 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.
get_audience_limitsReturns the authenticated account's current plan (planName, as the app names it), its Audience size allowance (per-Audience cap including any team or contract allowance, customSizeMax, per-mode ceilings) and the synthetic responses left, read live; it supersedes limits stated elsewhere.
ask_audienceAsks exactly one standalone question of one existing Audience.
export_audienceExports 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.
duplicate_audiencePermanently copy an Audience with independent copies of its Minds and all they know.
recalibrate_audienceChanges an existing Audience in place: it keeps its id, its Minds keep theirs (except copies below), and no Mind is deleted.
manage_audience_supportManage owner-issued, expiring staff access to one Audience’s composition and receipts.
list_studiesLists the authenticated user's Studies, most recently updated first, one page at a time: limit (default 20) and offset, with nextOffset to continue.
create_studyCreates a Study workspace from existing Audiences or inline Audience configurations.
ask_studySubmits exactly one respondent-visible question: one standalone question, or one adaptive follow-up whose wording could not be known before earlier results.
get_study_statusReturns Study progress, per-Audience results, original Mind responses, links and export status.
render_study_resultsShows 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.
export_studyStarts an asynchronous export of Study results and returns an export job ID.
duplicate_studyPermanently copy a Study with its questions and results over the same Audiences.
export_heatmapExports a completed website heatmap from a Study result, identified by the message ID reported with the completed result.
get_study_heatmapReads saved heatmaps of an assigned question asset.
start_study_heatmapStarts attention analysis of an assigned image, video or website.
export_mindGenerates a branded profile for one existing Mind, identified by exact ID or name (partial names and typos resolve to the closest).
get_shared_mind_knowledgeRead shared Mind sources and assessments.
create_study_planCreates a non-executing draft in an existing Study with its Audiences already attached.
revise_study_planRevises one saved draft at its current draft.id and draft.revision without starting research.
get_study_planReads the latest saved revision and full review of one draft.
attach_study_audiencesAdds existing accessible Audiences without removing others, planning or starting research.
render_study_planShows a saved Study draft at its current revision for interactive review and confirmation.
start_study_runRuns one reviewed draft revision after explicit confirmation in a later user turn; skipping review is not confirmation.
resume_study_runResumes an existing plan-limited Study run in place after explicit user approval and the required paid-plan entitlement.
cancel_study_questionStops one standalone Study question by runId, or studyId and questionId: queued or preparing stops at once, being answered stops at its next step.
update_itemRenames a Study or Audience or moves it into a folder.
set_sharingTurns a Study's or Audience's public link or team sharing on or off.
list_research_methodsReads the fixed Minds research-method catalog in one operation, including availability, complexity and fallback method.
list_study_draftsLists a page of unfinished Study draft summaries, newest first, or returns the complete saved planning state for one exact draft ID.
list_study_templatesLists 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.
save_study_draftCreates or checkpoints an unfinished Quick or Custom Study draft without starting research.
save_study_templateCreates a private Custom template with its questions, response settings, attachments and method.
update_study_templateUpdates one owned Custom template at update.expectedRevision.
use_study_templateCreates an independent editable Study draft from a readable template at use.expectedRevision.
delete_study_templateOnly for saved Study templates; it cannot delete Studies, Audiences, Minds or answers.
read_study_summaryReads saved whole-Study Markdown, evidence blocks and metadata.
refresh_study_summaryGenerates and saves a whole-Study summary after explicit approval.
plan_study_questionsDeprecated alias of create_study_plan and revise_study_plan; identical behaviour.
run_study_questionsDeprecated 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.json
  • OAuth protected resource metadata: https://getminds.ai/.well-known/oauth-protected-resource/mcp
  • Registry name: ai.getminds/minds

Links

Source: README.md at commit c92bf8a

Tools

0
This server asks you to sign in, so SourceWeft could not read its tools without an account and has not indexed them. What a connected account sees can depend on that account and its permissions.

Version history

1
  1. v2.0.2LatestSep 16, 2026

Score

85% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 daysRequired25 pts
  • Auth declaredRequired10 pts
  • Tools listed15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts