Minds: Synthetic Market Research

Run a Confirmed Multi-Question Block

run_study_questions

DestructiveIdempotent

Deprecated alias of start_study_run; identical behaviour.

Input Schema

Name	Required	Description	Default
`draft`	No
`study`	No
`resume`	No
`confirmed`	No
`audienceIds`	No
`idempotencyKey`	No
`modelConnection`	No
`advancedMethodOptIn`	No

Output 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.
`studyId`	No	Study the block runs in.
`workspaceUrl`	No	Authenticated Minds workspace link for the Study.
`executionStarted`	No	False when nothing started.

Schema Changelog

Changes observed during successful MCP inspections.

Changed1 schema field changedNov 7, 2026

addedOutput schema / properties / workspaceUrl

Added value: +{
+  "description": "Authenticated Minds workspace link for the Study.",
+  "type": [
+    "string",
+    "null"
+  ]
+}

AddedOct 20, 2026
RemovedOct 8, 2026

Changed1 schema field changedOct 7, 2026

changedInput schema / properties / study / properties / name / description

Previous value: -"Study name to fuzzy-match among the newest 1,000 visible Studies; use studyId for older records. Omit with studyId to run in the active Study."New value: +"Study name (exact or partial, case-insensitive; fuzzy fallback for typos). Omit with studyId to run in the active Study."

Changed1 schema field changedOct 6, 2026

changedOutput schema / properties / runId / description

Previous value: -"Durable run; poll it with get_study_run."New value: +"Durable run; poll it with get_study_status (study.id and runId)."

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

Changed13 schema fields changedOct 2, 2026

changedOutput schema / properties / planLimit / anyOf

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

removedOutput schema / properties / requestedQuestionCount / anyOf

Removed value: -[
-  {
-    "type": "number"
-  },
-  {
-    "type": "null"
-  }
-]

addedOutput schema / properties / requestedQuestionCount / type
```
Added value: +[
+  "number",
+  "null"
+]
```

removedOutput schema / properties / resumed / anyOf

Removed value: -[
-  {
-    "type": "boolean"
-  },
-  {
-    "type": "null"
-  }
-]

addedOutput schema / properties / resumed / type
```
Added value: +[
+  "boolean",
+  "null"
+]
```

removedOutput schema / properties / runId / anyOf

Removed value: -[
-  {
-    "type": "string"
-  },
-  {
-    "type": "null"
-  }
-]

addedOutput schema / properties / runId / type
```
Added value: +[
+  "string",
+  "null"
+]
```

removedOutput schema / properties / skippedQuestionCount / anyOf

Removed value: -[
-  {
-    "type": "number"
-  },
-  {
-    "type": "null"
-  }
-]

addedOutput schema / properties / skippedQuestionCount / type
```
Added value: +[
+  "number",
+  "null"
+]
```

removedOutput schema / properties / studyId / anyOf

Removed value: -[
-  {
-    "type": "string"
-  },
-  {
-    "type": "null"
-  }
-]

addedOutput schema / properties / studyId / type
```
Added value: +[
+  "string",
+  "null"
+]
```

removedOutput schema / properties / workspaceUrl / anyOf

Removed value: -[
-  {
-    "type": "string"
-  },
-  {
-    "type": "null"
-  }
-]

addedOutput schema / properties / workspaceUrl / type
```
Added value: +[
+  "string",
+  "null"
+]
```

Changed8 schema fields changedOct 1, 2026

changedInput schema / properties / confirmed / description

Previous value: -"Must be true only after the user explicitly confirms this exact draft revision."New value: +"Must be true only after the user explicitly confirms this exact draft revision, or confirms continuing the stopped run named in resume."

changedInput schema / properties / draft / description

Previous value: -"The exact confirmed draft revision to execute."New value: +"The exact confirmed draft revision to execute. Required unless resume is given."

addedInput schema / properties / resume

Added value: +{
+  "description": "Continue a run that stopped at a plan limit, in place, instead of executing a draft. Its original confirmed questions and answer contracts are kept and questions that already have answers are not asked again. Needs a paid plan.",
+  "properties": {
+    "runId": {
+      "description": "The plan_limited run to continue.",
+      "format": "uuid",
+      "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
+      "type": "string"
+    }
+  },
+  "required": [
+    "runId"
+  ],
+  "type": "object"
+}

changedInput schema / required

Previous value: -[
-  "confirmed",
-  "draft"
-]New value: +[
+  "confirmed"
+]

addedOutput schema / properties / planLimit

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

addedOutput schema / properties / requestedQuestionCount

Added value: +{
+  "anyOf": [
+    {
+      "type": "number"
+    },
+    {
+      "type": "null"
+    }
+  ],
+  "description": "Questions in the confirmed plan."
+}

addedOutput schema / properties / resumed

Added value: +{
+  "anyOf": [
+    {
+      "type": "boolean"
+    },
+    {
+      "type": "null"
+    }
+  ],
+  "description": "With resume: true when the stopped run was queued again."
+}

addedOutput schema / properties / skippedQuestionCount

Added value: +{
+  "anyOf": [
+    {
+      "type": "number"
+    },
+    {
+      "type": "null"
+    }
+  ],
+  "description": "Questions left out of this run by the Free plan Study answer allowance."
+}

Changed10 schema fields changedSep 22, 2026

addedInput schema / properties / draft

Added value: +{
+  "description": "The exact confirmed draft revision to execute.",
+  "properties": {
+    "id": {
+      "description": "Exact draft plan ID returned by plan_study_questions.",
+      "format": "uuid",
+      "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
+      "type": "string"
+    },
+    "revision": {
+      "description": "Exact draft revision the user reviewed.",
+      "exclusiveMinimum": 0,
+      "maximum": 9007199254740991,
+      "type": "integer"
+    }
+  },
+  "required": [
+    "id",
+    "revision"
+  ],
+  "type": "object"
+}

removedInput schema / properties / draftPlanId

Removed value: -{
-  "description": "Exact draft plan ID returned by plan_study_questions.",
-  "format": "uuid",
-  "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
-  "type": "string"
-}

removedInput schema / properties / groupIds

Removed value: -{
-  "description": "Legacy alias for audienceIds. Accepted for compatibility.",
-  "items": {
-    "format": "uuid",
-    "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
-    "type": "string"
-  },
-  "type": "array"
-}

removedInput schema / properties / panelId

Removed value: -{
-  "description": "Study ID (UUID; legacy wire field name: panelId). Omit both panelId and panelName only to run the confirmed draft in the active Study from this MCP session.",
-  "format": "uuid",
-  "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
-  "type": "string"
-}

removedInput schema / properties / panelName

Removed value: -{
-  "description": "Study name for fuzzy matching (legacy wire field name: panelName). Omit both panelName and panelId only to run the confirmed draft in the active Study from this MCP session.",
-  "type": "string"
-}

removedInput schema / properties / revision

Removed value: -{
-  "description": "Exact draft revision the user reviewed.",
-  "exclusiveMinimum": 0,
-  "maximum": 9007199254740991,
-  "type": "integer"
-}

addedInput schema / properties / study

Added value: +{
+  "description": "Which Study to run in. Omit entirely to use the active Study from this MCP session.",
+  "properties": {
+    "id": {
+      "description": "Study ID (UUID). Omit with studyName to run in the active Study.",
+      "format": "uuid",
+      "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
+      "type": "string"
+    },
+    "name": {
+      "description": "Study name to fuzzy-match among the newest 1,000 visible Studies; use studyId for older records. Omit with studyId to run in the active Study.",
+      "type": "string"
+    }
+  },
+  "type": "object"
+}

removedInput schema / properties / studyId

Removed value: -{
-  "description": "Study ID (UUID). Omit with studyName to run in the active Study.",
-  "format": "uuid",
-  "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
-  "type": "string"
-}

removedInput schema / properties / studyName

Removed value: -{
-  "description": "Study name to fuzzy-match among the newest 1,000 visible Studies; use studyId for older records. Omit with studyId to run in the active Study.",
-  "type": "string"
-}

changedInput schema / required

Previous value: -[
-  "draftPlanId",
-  "revision",
-  "confirmed"
-]New value: +[
+  "confirmed",
+  "draft"
+]

Changed1 schema field changedSep 22, 2026

changedInput schema / properties / studyName / description

Previous value: -"Study name for fuzzy matching. Omit with studyId to run in the active Study."New value: +"Study name to fuzzy-match among the newest 1,000 visible Studies; use studyId for older records. Omit with studyId to run in the active Study."

Changed1 schema field changedSep 20, 2026

changedOutput schema / (root)

Previous value: -nullNew value: +{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "additionalProperties": {},
+  "properties": {
+    "executionStarted": {
+      "description": "False when nothing started."
+    },
+    "runId": {
+      "anyOf": [
+        {
+          "type": "string"
+        },
+        {
+          "type": "null"
+        }
+      ],
+      "description": "Durable run; poll it with get_study_run."
+    },
+    "status": {
+      "description": "Run status, or stimulus_unavailable / plan_limited when nothing started."
+    },
+    "studyId": {
+      "anyOf": [
+        {
+          "type": "string"
+        },
+        {
+          "type": "null"
+        }
+      ],
+      "description": "Study the block runs in."
+    },
+    "workspaceUrl": {
+      "anyOf": [
+        {
+          "type": "string"
+        },
+        {
+          "type": "null"
+        }
+      ],
+      "description": "Minds workspace link for the Study."
+    }
+  },
+  "type": "object"
+}

Changed1 schema field changedSep 10, 2026

addedInput schema / properties / modelConnection

Added value: +{
+  "additionalProperties": false,
+  "description": "Verified caller-team connection for Mind answers and verbatim rendering. Select only when the user requests it; confirmation pins this connection revision, and retries must keep it. Supporting analysis retains platform models.",
+  "properties": {
+    "id": {
+      "format": "uuid",
+      "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
+      "type": "string"
+    },
+    "revision": {
+      "exclusiveMinimum": 0,
+      "maximum": 9007199254740991,
+      "type": "integer"
+    }
+  },
+  "required": [
+    "id",
+    "revision"
+  ],
+  "type": "object"
+}

AddedAug 27, 2026

TDQS

B3.2/5.0

Behavior2/5

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

Annotations declare destructiveHint=true, openWorldHint=true and idempotentHint=true; the description adds no behavioural detail about what the destructive action affects, whether confirmation is required, or what the open-world interaction touches. "Identical behaviour" is a cross-reference, not a disclosure, so beyond the annotation profile the description contributes almost nothing.

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?

A single front-loaded sentence with zero filler; the deprecation notice and the behavioural equivalence are both stated immediately. Nothing can be trimmed without losing either signal.

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

Completeness2/5

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

For a destructive, open-world tool with 8 undocumented parameters (and an output schema it need not explain), one sentence about being deprecated is thin. It omits any safety context around the destructive run, what the confirmed/audienceIds inputs mean, and why this entry point still exists.

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

Parameters2/5

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

There are 8 parameters with 0% schema description coverage and no enums, so the description carries the full burden of explaining draft, study, confirmed, audienceIds, idempotencyKey and modelConnection. Saying behaviour is identical to start_study_run implies the parameters mirror that tool, which is a useful pointer but no actual semantics are supplied.

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?

The description identifies exactly what the tool is (a deprecated alias of start_study_run with identical behaviour), which is precise enough for an agent to know it duplicates a named sibling. It stops short of stating the underlying operation (starting a study run over a confirmed question block), so the agent must consult start_study_run to learn the actual verb+resource.

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?

"Deprecated alias" plus "identical behaviour" is a clear, actionable routing signal: prefer the canonical tool. It does not state whether any caller must still use this name for backward compatibility, nor does it name the replacement with an explicit 'use X instead' directive, leaving a small gap.

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.