Get Study Status
get_study_statusDestructiveIdempotent
Returns Study progress, Audience results, Mind responses and export status in the Study display locale. questionId selects a question or durable request preparation; runId selects a confirmed run; otherwise covers the Study. In-flight questions show zero answered until complete. requestPreparations separates interpretation/review/admission from answers. Result reads can queue recovery and overwrite stale derived analysis from accepted answers, without rerunning respondents. Export-only polling reads its job.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| runId | No | Multi-question run ID from start_study_run. Supplying it returns that run: its confirmed plan, question-level progress and response artifacts, instead of the Study-wide view. | |
| study | No | Which Study to inspect. Omit entirely to use the active Study from this MCP session. | |
| export | No | Poll one asynchronous export job created by the export operation. | |
| questionId | No | Return only this request or question: use the questionId returned by ask_study or ask_audience, including a preparing receipt, on the first progress check for that request. The same logical ID follows preparation and any admitted question; operationId is a separate preparation identifier, not a questionId. An activeQuestions/recentResults questionId also selects that question. Omit only for a Study-wide progress request. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| 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. | |
| requestPreparations | No | Accepted request preparation receipts, separate from questions and results. preparing has no submitted question; planning_required retains the original request and proposed plan awaiting explicit confirmation, and an uploaded questionnaire's questionnaire with the exact draft (draftPlanId, revision) that start_study_run starts after confirmation; admitted identifies a run whose own row supplies progress. clientRequestId selects the same request through get_study_status questionId. | |
| isLinkSharingEnabled | No | Whether the public share link is on. |