Minds: Synthetic Market Research

Resume Study Run

resume_study_run

Idempotent

Resumes an existing plan-limited Study run in place after explicit user approval and the required paid-plan entitlement. Keeps the originally confirmed questions and response contracts and does not ask questions already answered. Does not start a new draft or change the run design.

Input Schema

TableJSON Schema

Name	Required	Description
`runId`	Yes	Existing plan-limited run to resume in place.
`study`	No	Study id or name. Omit to use the active Study of this MCP session.
`confirmed`	Yes	The user explicitly approved continuing this stopped run.

Output Schema

TableJSON Schema

Name	Required	Description
`runId`	No	Durable run; poll it with get_study_status (study.id and runId).
`status`	No	Run status, or stimulus_unavailable / plan_limited when nothing started.
`resumed`	No	With resume: true when the stopped run was queued again.
`studyId`	No	Study the block runs in.
`planLimit`	No	Present when a plan limit refused, truncated or stopped Study work.
`workspaceUrl`	No	Minds workspace link for the Study.
`executionStarted`	No	False when nothing started.
`skippedQuestionCount`	No	Questions left out of this run by the Free plan Study answer allowance.
`requestedQuestionCount`	No	Questions in the confirmed plan.

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"
+  }
+]

AddedOct 8, 2026

TDQS

A4.4/5.0

Behavior5/5

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

Annotations declare readOnly=false, idempotent=true, and destructive=false, but the description adds substantive context they cannot: the paid-plan entitlement requirement, the explicit-approval gate, and the preservation semantics ('keeps the originally confirmed questions and response contracts and does not ask questions already answered'). This is genuine behavioral disclosure beyond structured fields.

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

Conciseness5/5

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

Three tight sentences, front-loaded with the core action and followed by preconditions and preservation semantics. No filler and nothing repeated from the schema.

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 explained, and the description covers prerequisites and mutation semantics for a non-read-only tool. It is slightly thin on failure behavior (e.g., what happens when the entitlement is absent), which keeps it from a 5.

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

Parameters3/5

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

Schema description coverage is 100%, so runId, study (id/name/precedence), and confirmed are already fully documented in the schema. The description adds no syntax or format detail beyond that, so the baseline 3 applies.

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

Purpose5/5

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

States a specific verb (Resumes) and resource (plan-limited Study run) with the key qualifier 'in place'. It implicitly routes away from start_study_run by stating it 'does not start a new draft or change the run design,' so an agent can distinguish the two without opening either schema.

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

Usage Guidelines4/5

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

Gives clear preconditions – an existing stopped run, explicit user approval, and the required paid-plan entitlement. It does not explicitly name the alternative tool (start_study_run) for the create-new case, leaving that routing to inference, which keeps it just below a 5.

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.