Get Study Status
get_study_statusRead-onlyIdempotent
Returns Study progress, per-Audience results, original Mind responses, links and export status. In-flight questions report zero Minds answered until completion; partial per-Mind progress is not persisted. questionId selects one question; runId selects a confirmed run with question-level counters. Without either, results cover the entire Study. Values and labels are written in the Study display locale, returned as locale: the language of its confirmed plan, else the stored Study locale, else English.
Input Schema
TableJSON 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 question: the questionId from ask_study or ask_audience, or from an activeQuestions/recentResults entry. Keeps the response small. Omit to cover every question the Study has run. |
Output Schema
TableJSON 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. | |
| isLinkSharingEnabled | No | Whether the public share link is on. |