Interaction state MCP response
MCP tool response returned by the Interaction state MCP tool.
- Returned by: Interaction state MCP tool
- Response type: Structured app state
Response Shape
The response is the canonical state for one interactive MCP app interaction after a read or write.
| Field | Type | Notes |
|---|---|---|
interactionId | string | Interaction identifier generated by an interactive app. It begins with the app kind, such as option_list: or geo_map:. |
kind | string | Interaction kind. Values include document_annotation, geo_map, option_list, question_flow, and preferences_panel. |
status | string | Lifecycle status. Values include pending, submitted, completed, cancelled, and failed. |
isInteractive | boolean | Whether the interaction should still accept user input. |
| App-specific fields | mixed | The normalized state for the app, such as selected, answers, values, selectedMarkerIds, or annotations. |
statusUpdatedAt | string or null | ISO timestamp for the latest persisted state update. |
Follow-up Behavior
Use this response after a user submits or updates an interactive app. Terminal statuses are completed, cancelled, and failed; active statuses are pending and submitted.
Example
{
"interactionId": "option_list:INTERACTION_ID",
"kind": "option_list",
"status": "submitted",
"isInteractive": false,
"selected": {
"id": "option-a",
"label": "Option A"
},
"statusUpdatedAt": "2026-05-06T12:00:00+00:00"
}