Minds: Synthetic Market Research

Show Final Study Results

render_study_results

Read-onlyIdempotent

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. Use it whenever the user asks about results. Requires exactly one of questionId or runId.

Input Schema

TableJSON Schema

Name	Required	Description	Default
`runId`	No
`studyId`	Yes
`questionId`	No

Output Schema

TableJSON Schema

Name	Required	Description
`name`	No	Study name.
`runId`	No	The multi-question run, when one was requested.
`locale`	No	Study display locale.
`apiBase`	No	Minds base URL.
`studyId`	No	The Study.
`artifacts`	No	Results and artifacts of the requested run. A response artifact may carry answerConsistency {version, flags: [{mindId, withItem, reason}]}.
`audiences`	No	Audiences with their Minds.
`createdAt`	No	Creation time (ISO 8601).
`planLimit`	No	Present when a plan limit refused, truncated or stopped Study work.
`updatedAt`	No	Last update time (ISO 8601).
`formations`	No	Audience breakdowns available for the results.
`exportStatus`	No	Status of the requested asynchronous export job, if any.
`messageCount`	No	Number of Study messages.
`workspaceUrl`	No	Authenticated Minds workspace link for the Study.
`publicShareId`	No	Public share identifier, or null.
`recentResults`	No	Completed questions with their per-Audience outputData and stimuli (the media the Minds were shown: name, url, mediaType). For coded qualitative answers, audiences[].themeMentions counts Minds per theme (multi-label, can exceed 100% in total) while distribution counts only each answer's primary theme.
`sharedStudyUrl`	No	Public share link, or null when link sharing is off.
`activeQuestions`	No	Questions still running: questionId, question, status, totalMinds, answeredCount.
`failedQuestions`	No	Questions that failed, with an error; a question a plan limit kept from running also carries planLimit.
`answerConsistency`	No	Run with runId only: whether each Mind's answers were checked against each other. version, status (checked \| incomplete \| failed), checkedMinds, flaggedMinds, flagCount, uncheckedMinds, usage {calls, inputTokens, outputTokens}, and unsavedItems (question indexes whose flags could not be saved) when any. A failed check records only version and status.
`studyPresentation`	No	Saved Study headings and original question context aligned by questionId; used by the response widget.
`isLinkSharingEnabled`	No	Whether the public share link is on.

Schema Changelog

Changes observed during successful MCP inspections.

Changed1 schema field changedOct 10, 2026

changedOutput schema / properties / planLimit / anyOf

Previous value: -[
-  {
-    "additionalProperties": {},
-    "properties": {
-      "executionStarted": {
-        "description": "Whether any question of this request ran.",
-        "type": [
-          "boolean",
-          "null"
-        ]
-      },
-      "kind": {
-        "description": "study_answers (Free plan monthly Study answers) or response_credits (synthetic-response allowance).",
-        "type": [
-          "string",
-          "null"
-        ]
-      },
-      "limit": {
-        "description": "Allowance of the current period, when known.",
-        "type": [
-          "number",
-          "null"
-        ]
-      },
-      "message": {
-        "description": "One user-facing sentence with the link(s).",
-        "type": [
-          "string",
-          "null"
-        ]
-      },
-      "outcome": {
-        "description": "refused (nothing started or charged), partial (only the first questions run), stopped (a run stopped at the limit), or resume_refused.",
-        "type": [
-          "string",
-          "null"
-        ]
-      },
-      "periodEnd": {
-        "description": "When the allowance renews (ISO 8601), when known.",
-        "type": [
-          "string",
-          "null"
-        ]
-      },
-      "remaining": {
-        "description": "Allowance left, when known.",
-        "type": [
-          "number",
-          "null"
-        ]
-      },
-      "requested": {
-        "description": "Responses or answers the refused work needed, when known.",
-        "type": [
-          "number",
-          "null"
-        ]
-      },
-      "responseCreditsUrl": {
-        "description": "Absolute link to buy response credits; only for response_credits.",
-        "type": [
-          "string",
-          "null"
-        ]
-      },
-      "resumable": {
-        "description": "True when the run can be continued in place with resume_study_run runId once the plan allows it.",
-        "type": [
-          "boolean",
-          "null"
-        ]
-      },
-      "runId": {
-        "description": "The run concerned, when one exists.",
-        "type": [
-          "string",
-          "null"
-        ]
-      },
-      "skippedQuestionCount": {
-        "description": "Questions the limit kept from running.",
-        "type": [
-          "number",
-          "null"
-        ]
-      },
-      "skippedQuestions": {
-        "anyOf": [
-          {
-            "items": {},
-            "type": "array"
-          },
-          {
-            "type": "null"
-          }
-        ],
-        "description": "Questions not asked: { index (zero-based), text }."
-      },
-      "totalQuestionCount": {
-        "description": "Questions in the request or run, when known.",
-        "type": [
-          "number",
-          "null"
-        ]
-      },
-      "upgradeUrl": {
-        "description": "Absolute link to the Minds plans page.",
-        "type": [
-          "string",
-          "null"
-        ]
-      },
-      "used": {
-        "description": "Allowance used in the current period, when known.",
-        "type": [
-          "number",
-          "null"
-        ]
-      }
-    },
-    "type": "object"
-  },
-  {
-    "type": "null"
-  }
-]New value: +[
+  {
+    "additionalProperties": {},
+    "properties": {
+      "billingMode": {
+        "description": "prepaid (purchased response balance) or subscription (recurring allowance), when known.",
+        "type": [
+          "string",
+          "null"
+        ]
+      },
+      "context": {
+        "description": "sharedStudyUsage or sharedMindUsage when the owner pays for the refused work.",
+        "type": [
+          "string",
+          "null"
+        ]
+      },
+      "executionStarted": {
+        "description": "Whether any question of this request ran.",
+        "type": [
+          "boolean",
+          "null"
+        ]
+      },
+      "kind": {
+        "description": "study_answers (Free plan monthly Study answers) or response_credits (synthetic-response allowance).",
+        "type": [
+          "string",
+          "null"
+        ]
+      },
+      "limit": {
+        "description": "Allowance of the current period, when known.",
+        "type": [
+          "number",
+          "null"
+        ]
+      },
+      "message": {
+        "description": "One user-facing sentence with the link(s).",
+        "type": [
+          "string",
+          "null"
+        ]
+      },
+      "outcome": {
+        "description": "refused (nothing started or charged), partial (only the first questions run), stopped (a run stopped at the limit), or resume_refused.",
+        "type": [
+          "string",
+          "null"
+        ]
+      },
+      "periodEnd": {
+        "description": "When the allowance renews (ISO 8601), when known.",
+        "type": [
+          "string",
+          "null"
+        ]
+      },
+      "remaining": {
+        "description": "Allowance left, when known.",
+        "type": [
+          "number",
+          "null"
+        ]
+      },
+      "requested": {
+        "description": "Responses or answers the refused work needed, when known.",
+        "type": [
+          "number",
+          "null"
+        ]
+      },
+      "responseCreditsUrl": {
+        "description": "Absolute link to buy response credits; only for response_credits and absent when the shared owner must act.",
+        "type": [
+          "string",
+          "null"
+        ]
+      },
+      "resumable": {
+        "description": "True when the run can be continued in place with resume_study_run runId once the plan allows it.",
+        "type": [
+          "boolean",
+          "null"
+        ]
+      },
+      "runId": {
+        "description": "The run concerned, when one exists.",
+        "type": [
+          "string",
+          "null"
+        ]
+      },
+      "skippedQuestionCount": {
+        "description": "Questions the limit kept from running.",
+        "type": [
+          "number",
+          "null"
+        ]
+      },
+      "skippedQuestions": {
+        "anyOf": [
+          {
+            "items": {},
+            "type": "array"
+          },
+          {
+            "type": "null"
+          }
+        ],
+        "description": "Questions not asked: { index (zero-based), text }."
+      },
+      "totalQuestionCount": {
+        "description": "Questions in the request or run, when known.",
+        "type": [
+          "number",
+          "null"
+        ]
+      },
+      "upgradeUrl": {
+        "description": "Absolute link to the Minds plans page; absent when the shared owner must act.",
+        "type": [
+          "string",
+          "null"
+        ]
+      },
+      "used": {
+        "description": "Allowance used in the current period, when known.",
+        "type": [
+          "number",
+          "null"
+        ]
+      }
+    },
+    "type": "object"
+  },
+  {
+    "type": "null"
+  }
+]

Changed1 schema field changedOct 8, 2026

changedOutput schema / properties / planLimit / anyOf

Previous value: -[
-  {
-    "additionalProperties": {},
-    "properties": {
-      "executionStarted": {
-        "description": "Whether any question of this request ran.",
-        "type": [
-          "boolean",
-          "null"
-        ]
-      },
-      "kind": {
-        "description": "study_answers (Free plan monthly Study answers) or response_credits (synthetic-response allowance).",
-        "type": [
-          "string",
-          "null"
-        ]
-      },
-      "limit": {
-        "description": "Allowance of the current period, when known.",
-        "type": [
-          "number",
-          "null"
-        ]
-      },
-      "message": {
-        "description": "One user-facing sentence with the link(s).",
-        "type": [
-          "string",
-          "null"
-        ]
-      },
-      "outcome": {
-        "description": "refused (nothing started or charged), partial (only the first questions run), stopped (a run stopped at the limit), or resume_refused.",
-        "type": [
-          "string",
-          "null"
-        ]
-      },
-      "periodEnd": {
-        "description": "When the allowance renews (ISO 8601), when known.",
-        "type": [
-          "string",
-          "null"
-        ]
-      },
-      "remaining": {
-        "description": "Allowance left, when known.",
-        "type": [
-          "number",
-          "null"
-        ]
-      },
-      "requested": {
-        "description": "Responses or answers the refused work needed, when known.",
-        "type": [
-          "number",
-          "null"
-        ]
-      },
-      "responseCreditsUrl": {
-        "description": "Absolute link to buy response credits; only for response_credits.",
-        "type": [
-          "string",
-          "null"
-        ]
-      },
-      "resumable": {
-        "description": "True when the run can be continued in place with run_study_questions resume.runId once the plan allows it.",
-        "type": [
-          "boolean",
-          "null"
-        ]
-      },
-      "runId": {
-        "description": "The run concerned, when one exists.",
-        "type": [
-          "string",
-          "null"
-        ]
-      },
-      "skippedQuestionCount": {
-        "description": "Questions the limit kept from running.",
-        "type": [
-          "number",
-          "null"
-        ]
-      },
-      "skippedQuestions": {
-        "anyOf": [
-          {
-            "items": {},
-            "type": "array"
-          },
-          {
-            "type": "null"
-          }
-        ],
-        "description": "Questions not asked: { index (zero-based), text }."
-      },
-      "totalQuestionCount": {
-        "description": "Questions in the request or run, when known.",
-        "type": [
-          "number",
-          "null"
-        ]
-      },
-      "upgradeUrl": {
-        "description": "Absolute link to the Minds plans page.",
-        "type": [
-          "string",
-          "null"
-        ]
-      },
-      "used": {
-        "description": "Allowance used in the current period, when known.",
-        "type": [
-          "number",
-          "null"
-        ]
-      }
-    },
-    "type": "object"
-  },
-  {
-    "type": "null"
-  }
-]New value: +[
+  {
+    "additionalProperties": {},
+    "properties": {
+      "executionStarted": {
+        "description": "Whether any question of this request ran.",
+        "type": [
+          "boolean",
+          "null"
+        ]
+      },
+      "kind": {
+        "description": "study_answers (Free plan monthly Study answers) or response_credits (synthetic-response allowance).",
+        "type": [
+          "string",
+          "null"
+        ]
+      },
+      "limit": {
+        "description": "Allowance of the current period, when known.",
+        "type": [
+          "number",
+          "null"
+        ]
+      },
+      "message": {
+        "description": "One user-facing sentence with the link(s).",
+        "type": [
+          "string",
+          "null"
+        ]
+      },
+      "outcome": {
+        "description": "refused (nothing started or charged), partial (only the first questions run), stopped (a run stopped at the limit), or resume_refused.",
+        "type": [
+          "string",
+          "null"
+        ]
+      },
+      "periodEnd": {
+        "description": "When the allowance renews (ISO 8601), when known.",
+        "type": [
+          "string",
+          "null"
+        ]
+      },
+      "remaining": {
+        "description": "Allowance left, when known.",
+        "type": [
+          "number",
+          "null"
+        ]
+      },
+      "requested": {
+        "description": "Responses or answers the refused work needed, when known.",
+        "type": [
+          "number",
+          "null"
+        ]
+      },
+      "responseCreditsUrl": {
+        "description": "Absolute link to buy response credits; only for response_credits.",
+        "type": [
+          "string",
+          "null"
+        ]
+      },
+      "resumable": {
+        "description": "True when the run can be continued in place with resume_study_run runId once the plan allows it.",
+        "type": [
+          "boolean",
+          "null"
+        ]
+      },
+      "runId": {
+        "description": "The run concerned, when one exists.",
+        "type": [
+          "string",
+          "null"
+        ]
+      },
+      "skippedQuestionCount": {
+        "description": "Questions the limit kept from running.",
+        "type": [
+          "number",
+          "null"
+        ]
+      },
+      "skippedQuestions": {
+        "anyOf": [
+          {
+            "items": {},
+            "type": "array"
+          },
+          {
+            "type": "null"
+          }
+        ],
+        "description": "Questions not asked: { index (zero-based), text }."
+      },
+      "totalQuestionCount": {
+        "description": "Questions in the request or run, when known.",
+        "type": [
+          "number",
+          "null"
+        ]
+      },
+      "upgradeUrl": {
+        "description": "Absolute link to the Minds plans page.",
+        "type": [
+          "string",
+          "null"
+        ]
+      },
+      "used": {
+        "description": "Allowance used in the current period, when known.",
+        "type": [
+          "number",
+          "null"
+        ]
+      }
+    },
+    "type": "object"
+  },
+  {
+    "type": "null"
+  }
+]

Changed1 schema field changedOct 4, 2026

changedOutput schema / properties / planLimit / anyOf

Previous value: -[
-  {
-    "additionalProperties": {},
-    "properties": {
-      "executionStarted": {
-        "description": "Whether any question of this request ran.",
-        "type": [
-          "boolean",
-          "null"
-        ]
-      },
-      "kind": {
-        "description": "study_answers (Free plan monthly Study answers) or response_credits (synthetic-response allowance).",
-        "type": [
-          "string",
-          "null"
-        ]
-      },
-      "limit": {
-        "description": "Allowance of the current period, when known.",
-        "type": [
-          "number",
-          "null"
-        ]
-      },
-      "message": {
-        "description": "One user-facing sentence with the link(s).",
-        "type": [
-          "string",
-          "null"
-        ]
-      },
-      "outcome": {
-        "description": "refused (nothing started or charged), partial (only the first questions run), stopped (a run stopped at the limit), or resume_refused.",
-        "type": [
-          "string",
-          "null"
-        ]
-      },
-      "periodEnd": {
-        "description": "When the allowance renews (ISO 8601), when known.",
-        "type": [
-          "string",
-          "null"
-        ]
-      },
-      "remaining": {
-        "description": "Allowance left, when known.",
-        "type": [
-          "number",
-          "null"
-        ]
-      },
-      "responseCreditsUrl": {
-        "description": "Absolute link to buy response credits; only for response_credits.",
-        "type": [
-          "string",
-          "null"
-        ]
-      },
-      "resumable": {
-        "description": "True when the run can be continued in place with run_study_questions resume.runId once the plan allows it.",
-        "type": [
-          "boolean",
-          "null"
-        ]
-      },
-      "runId": {
-        "description": "The run concerned, when one exists.",
-        "type": [
-          "string",
-          "null"
-        ]
-      },
-      "skippedQuestionCount": {
-        "description": "Questions the limit kept from running.",
-        "type": [
-          "number",
-          "null"
-        ]
-      },
-      "skippedQuestions": {
-        "anyOf": [
-          {
-            "items": {},
-            "type": "array"
-          },
-          {
-            "type": "null"
-          }
-        ],
-        "description": "Questions not asked: { index (zero-based), text }."
-      },
-      "totalQuestionCount": {
-        "description": "Questions in the request or run, when known.",
-        "type": [
-          "number",
-          "null"
-        ]
-      },
-      "upgradeUrl": {
-        "description": "Absolute link to the Minds plans page.",
-        "type": [
-          "string",
-          "null"
-        ]
-      },
-      "used": {
-        "description": "Allowance used in the current period, when known.",
-        "type": [
-          "number",
-          "null"
-        ]
-      }
-    },
-    "type": "object"
-  },
-  {
-    "type": "null"
-  }
-]New value: +[
+  {
+    "additionalProperties": {},
+    "properties": {
+      "executionStarted": {
+        "description": "Whether any question of this request ran.",
+        "type": [
+          "boolean",
+          "null"
+        ]
+      },
+      "kind": {
+        "description": "study_answers (Free plan monthly Study answers) or response_credits (synthetic-response allowance).",
+        "type": [
+          "string",
+          "null"
+        ]
+      },
+      "limit": {
+        "description": "Allowance of the current period, when known.",
+        "type": [
+          "number",
+          "null"
+        ]
+      },
+      "message": {
+        "description": "One user-facing sentence with the link(s).",
+        "type": [
+          "string",
+          "null"
+        ]
+      },
+      "outcome": {
+        "description": "refused (nothing started or charged), partial (only the first questions run), stopped (a run stopped at the limit), or resume_refused.",
+        "type": [
+          "string",
+          "null"
+        ]
+      },
+      "periodEnd": {
+        "description": "When the allowance renews (ISO 8601), when known.",
+        "type": [
+          "string",
+          "null"
+        ]
+      },
+      "remaining": {
+        "description": "Allowance left, when known.",
+        "type": [
+          "number",
+          "null"
+        ]
+      },
+      "requested": {
+        "description": "Responses or answers the refused work needed, when known.",
+        "type": [
+          "number",
+          "null"
+        ]
+      },
+      "responseCreditsUrl": {
+        "description": "Absolute link to buy response credits; only for response_credits.",
+        "type": [
+          "string",
+          "null"
+        ]
+      },
+      "resumable": {
+        "description": "True when the run can be continued in place with run_study_questions resume.runId once the plan allows it.",
+        "type": [
+          "boolean",
+          "null"
+        ]
+      },
+      "runId": {
+        "description": "The run concerned, when one exists.",
+        "type": [
+          "string",
+          "null"
+        ]
+      },
+      "skippedQuestionCount": {
+        "description": "Questions the limit kept from running.",
+        "type": [
+          "number",
+          "null"
+        ]
+      },
+      "skippedQuestions": {
+        "anyOf": [
+          {
+            "items": {},
+            "type": "array"
+          },
+          {
+            "type": "null"
+          }
+        ],
+        "description": "Questions not asked: { index (zero-based), text }."
+      },
+      "totalQuestionCount": {
+        "description": "Questions in the request or run, when known.",
+        "type": [
+          "number",
+          "null"
+        ]
+      },
+      "upgradeUrl": {
+        "description": "Absolute link to the Minds plans page.",
+        "type": [
+          "string",
+          "null"
+        ]
+      },
+      "used": {
+        "description": "Allowance used in the current period, when known.",
+        "type": [
+          "number",
+          "null"
+        ]
+      }
+    },
+    "type": "object"
+  },
+  {
+    "type": "null"
+  }
+]

AddedOct 2, 2026

TDQS

A3.8/5.0

Behavior4/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Annotations already declare readOnlyHint, idempotentHint and non-destructive, so the safety profile is covered. The description adds real behavioral context: it can render a run's finished questions while others still run (partial results), and it imposes a selection constraint the schema omits.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Two sentences, front-loaded with the capability and followed by the invocation constraint; no filler. The first sentence is dense with parenthetical enumerations but every element is informative.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness4/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

An output schema exists, so return values need not be described. For a three-parameter read tool, the description supplies the key constraint and partial-result behavior, leaving only sibling differentiation as a gap.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters4/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is 0%, so the description carries the burden and largely succeeds: it states that questionId and runId are mutually exclusive and that exactly one is required, and it describes what each selects (one question vs. a run's finished questions). It does not clarify studyId's role or the accepted identifier formats.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose4/5

Does the description clearly state what the tool does and how it differs from similar tools?

States a specific verb ('Shows') and resource ('results of finished questions'), and enumerates the returned content (summary, key findings, Audience breakdowns, Mind responses). It distinguishes the two modes (single question vs. a run's finished questions), though it does not explicitly separate itself from sibling tools like read_study_summary or get_study_status.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines3/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

'Use it whenever the user asks about results' gives an implied trigger but is overbroad, since siblings read_study_summary and refresh_study_summary also service results requests. No alternatives or exclusions are named, so the agent must infer when this tool is preferable.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

All Minds: Synthetic Market Research tools Inspect

Try in Browser

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

Glama MCP Gateway

Add one secure layer between your agents and this server.

Show Final Study Results

Input Schema

Output Schema

Schema Changelog

TDQS

Glama MCP Gateway

Resources