GovTribe
MCP tools

Interaction state MCP tool

Reads or persists canonical state for interactive MCP apps.

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.

Historical document_annotation:* interactions are read-only for apps and external MCP clients. Bootstrap, definition refresh, draft, submit and cancel payloads are rejected without creating or changing records. Read existing history without appUpdate. The authenticated GovTribe AI model may set only a terminal lifecycle status for its own conversation; it cannot attach annotation updates to that transition. New review belongs in the dedicated document pane.

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

Hide teaming interest

Operates in the cross-company GovTribe teaming network. Mark a teaming interest as hidden so it is no longer surfaced in cross-user discovery searches. Pre-existing match records remain visible to both parties; the hidden interest itself is no longer browsable by non-owners. Reverse later with Reopen_Teaming_Interest. Owner-only.

Invoke Search Tool

Describe or call a typed GovTribe search tool through a compact search wrapper. Call the Documentation MCP tool first for search query and search_mode guidance, then use mode=describe to retrieve the selected tool schema and documentation before mode=call. Search_GovTribe, Rerank_Search_Results, and Search_Vector_Store stay top-level; use this tool only for represented typed Search_* tools.

On this page

ExamplesRead the current state for an interactive widgetMark a user-driven interaction completePayload patternsStore selected map markers from a geo mapRelated articles