Skip to main content
Glama
minds-ai-co

Minds MCP Server

Official
by minds-ai-co
OverviewSchemaSourceRelated ServersDiscussionsAdmin
JavaScript
Remote

Minds MCP Server

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.

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

Tool

What it does

list_audiences

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 workspace or shared links.

import_audience_sources

Imports supplied UTF-8 text, Markdown, CSV and JSON research files into account-owned storage.

create_audience_from_brief

Researches a free-text population brief and builds Minds with explicit profiles and exact segment allocation.

submit_audience_review

Revise or confirm the displayed Audience review.

get_audience_creation_progress

Read one Audience creation operation and its members’ training progress.

render_audience_review

Shows source research, distributions, proposed Minds, review, confirmation and training for one or more Audience operations.

get_audience_limits

Returns the Audience size ceilings that apply to the authenticated account before an Audience is created: the per-Audience plan cap including any configured team allowance, the custom-size maximum, and the per-mode ceilings.

ask_audience

Asks exactly one standalone question of one existing Audience.

export_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.

duplicate_audience

Copy an Audience with independent copies of its Minds and all they know.

list_studies

Lists the authenticated user's Studies, most recently updated first, one page at a time: limit (default 20) and offset, with nextOffset to continue.

create_study

Creates a Study workspace from existing Audiences or inline Audience configurations.

ask_study

Submits exactly one respondent-visible question in an existing Study: one standalone question, or one adaptive follow-up whose wording could not be known before earlier results.

get_study_status

Returns Study progress, per-Audience results, original Mind responses, links and export status.

render_study_results

Shows final results, summary, key findings, Audience breakdowns and Mind responses for a completed question or multi-question run.

export_study

Starts an asynchronous export of Study results and returns an export job ID.

duplicate_study

Copy a Study with all its questions and results over the same Audiences.

export_heatmap

Exports a completed website heatmap from a Study result, identified by the message ID reported with the completed result.

run_study_heatmap

Read or start a question asset heatmap, with the same behavior as Minds UI.

export_mind

Generates a branded profile for one existing Mind, identified by exact ID or name (partial names and typos resolve to the closest).

get_shared_mind_knowledge

Read shared Mind sources and assessments.

plan_study_questions

Creates or revises a non-executing draft for a multi-question plan inside an existing Study.

render_study_plan

Shows a saved Study draft at its current revision for interactive review and confirmation.

run_study_questions

Executes one stored draft revision inside its Study, after the person has explicitly confirmed that exact revision.

list_research_methods

Lists Minds research methods with availability, complexity, executable status, and fallback metadata.

list_study_drafts

Lists a page of unfinished Study draft summaries, newest first, or returns the complete saved planning state for one exact draft ID.

list_study_templates

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.

save_study_draft

Creates or checkpoints an unfinished Quick or Custom Study draft without starting research.

manage_study_template

Saves, explicitly updates or uses a Custom research template.

delete_study_template

Only for saved Study templates; it cannot delete Studies, Audiences, Minds or answers.

get_study_summary

Returns or refreshes the semantic summary for a Study as Markdown plus flexible evidence blocks.

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

This server cannot be deployed

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Maintenance

ActivityMaintained
ResponsivenessNo issues

Resources

Related MCP Connectors

Related MCP Servers