Minds: Synthetic Market Research Panels vs Agent Search MCP

M

create_panel

Creates a new research Panel from existing Groups or inline Group configurations when the intended outcome is a new Panel. Follow-up research on an existing Panel does not require creation. Composite creation is atomic and rolls back partial Group failures. Panels are private by default; enabling link sharing also publishes the attached Groups and Minds.

ask_panel

Submits one respondent-visible question to an existing Panel and starts asynchronous responses from its Minds. Follow-up questions remain within the existing Panel; this operation does not create or enumerate Panels. 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.

export_panel

Starts an asynchronous export of Panel results and returns an export job ID. Supports executive briefs, full reports, and raw data in PDF, HTML, PNG ZIP, DOCX, PPTX, Markdown, CSV, XLS, or SPSS SAV formats, subject to report-kind compatibility.

export_mind

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.

export_group

Export a group brief through the same unified branded renderer used by the web app. Supports Markdown, PDF, DOCX, and PPTX. Binary artifacts are returned as base64.

export_heatmap

Export a completed website heatmap from a panel message, identified by the message ID that the panel reports on its completed results. Returns the same ZIP archive as the web app, including its unified-renderer PDF report, Markdown, images, and metadata.

list_panels

Lists the authenticated user's Panels with their Groups, Minds, status, sharing state, and workspace or shared links. Accepts an optional fuzzy name search. Panels may also be described as studies, surveys, research projects, focus groups, or research conversations.

get_panel_status

Returns current Panel state, live progress for in-flight questions, completed per-Group results, linked Minds, Panel links, and the status of a specific asynchronous export job when export identifiers are supplied.

list_groups

Lists the authenticated user's Groups, including member Minds, sharing state, and workspace or shared links. Accepts an optional fuzzy name search. Groups may also be described as audiences, segments, cohorts, target groups, or persona collections.

create_group_from_brief

Creates a grounded Group 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; is idempotent for identical inputs; and keeps the Group private unless link sharing is enabled.

ask_group

Submits one respondent-visible question to a single existing Group. The Group may be identified by exact ID or fuzzy name. The operation creates a private one-Group Panel, starts asynchronous responses from its Minds, and returns the Panel identifier and links for status retrieval.

plan_panel_study

Creates or revises a non-executing draft for a multi-question or structured Panel study. The draft records intent, respondent-visible stimulus and questions, response formats, locale, method, outputs, confirmation questions, and revision metadata. It does not start research.

free_search

Quick public-web search for current facts and discovery. Use free_search_advanced for verification or domain filters. Use free_extract for one selected URL. Returns compact multi-source evidence with confidence, relevance, source_count, stop_reason, evidence_budget, and partialFailures. Provider families are counted once even when several adapters use the same upstream. Optional API providers run only when credentials and policy allow. @readOnly true @idempotent true — makes outbound HTTP requests to configured search engines. Injection detection and SSRF protection active.

free_search_advanced

Verification-oriented search with domain filters and waterfall fallback. Use for claim checking, Chinese-source search, or publisher restrictions. Start with free_search for quick discovery. The response exposes source_count, stop_reason, evidence_budget, and partialFailures. @readOnly true @idempotent true — runs waterfall progressive search across policy-allowed engines. Makes outbound HTTP requests to search engines and optionally to Jina Reader for content enrichment.

free_extract

Extract one selected URL into clean Markdown. Use after search when snippets are insufficient, or for a URL supplied by the user. It fetches one page; it does not search or bulk-extract URLs. Behavior: Makes an outbound HTTP request to Jina Reader (r.jina.ai) which fetches and converts the page to markdown. Has SSRF protection: blocks private IPs, localhost, and metadata endpoints. 10s request timeout — pages exceeding this will fail with a timeout error. HTTP errors (4xx, 5xx) are returned as structured error responses.

fetch_github_readme

Fetch README content from a GitHub repository. Best for: Getting project documentation quickly. Not recommended for: Non-GitHub URLs — use free_extract instead. @readOnly true @idempotent true — makes outbound HTTP requests to raw.githubusercontent.com.