Interaction state MCP tool
Reads or persists canonical state for interactive MCP apps.
- MCP tool name:
Interaction_State - Returns: Interaction state MCP response
- Annotations: Not read only, not destructive, idempotent, closed world
- Surfaces: GovTribe AI
Examples
Use this to read or persist canonical state for interactive MCP apps after a user submits a selection, preference panel, map selection, or annotation review.
Read the current state for an interactive widget
{
"tool": "Interaction_State",
"arguments": {
"interactionId": "<interaction_id>"
}
}Mark a user-driven interaction complete
{
"tool": "Interaction_State",
"arguments": {
"interactionId": "<interaction_id>",
"status": "completed",
"appUpdate": {
"selectedOptionIds": [
"pursue",
"monitor"
],
"submittedAt": "2026-05-20T15:00:00Z"
}
}
}Payload patterns
appUpdate is app-managed state. Use it to preserve the widget submission payload, not to invent unrelated model state.
Store selected map markers from a geo map
{
"tool": "Interaction_State",
"arguments": {
"interactionId": "facility-map-2026-05-20",
"status": "completed",
"appUpdate": {
"selectedMarkerIds": [
"norfolk-naval-shipyard",
"navsea-hq"
],
"selectionMode": "multi"
}
}
}Related articles
- Interaction state MCP response: Review the response shape returned by this tool.
- GovTribe AI: Review the GovTribe AI surface where this tool can be called.