GovTribe
MCP tools

Show document MCP tool

Preview a GovTribe user file or government file read-only, with authorized download links. In GovTribe AI, use open_in_govtribe_ai and the document-editing workflow for editing or annotation review in the dedicated document pane.

Examples

Use this for a read-only preview of exactly one GovTribe file or shell artifact. The viewer provides an authorized Download action, including when the file type cannot be previewed inline. The file-access URLs can return attachment downloads; there is no separate inline-opening action. If a mounted preview stays open past its link deadline, selecting Download refreshes access before the host receives a URL.

Preview a government attachment and jump to evaluation criteria

{
  "tool": "Search_Government_Files",
  "arguments": {
    "query": "evaluation criteria facility modernization",
    "search_mode": "semantic",
    "fields_to_return": [
      "govtribe_id",
      "name",
      "parent_record"
    ]
  }
}
{
  "tool": "Show_Document",
  "arguments": {
    "external_file_id": "<government_file_govtribe_id>",
    "query": "evaluation criteria",
    "scroll_to_query": true
  }
}

Preview a generated shell artifact

{
  "tool": "Show_Document",
  "arguments": {
    "shell_file_identifier": "sandbox:/mnt/data/compliance-matrix.xlsx",
    "query": "Section M",
    "scroll_to_query": true
  }
}

Payload patterns

{
  "tool": "Show_Document",
  "arguments": {
    "user_file_id": "<user_file_govtribe_id>"
  }
}

Pass exactly one of user_file_id, external_file_id, or shell_file_identifier.

shell_file_identifier accepts any reference to a file from the current GovTribe AI conversation interchangeably: the file's name (for example compliance-matrix.xlsx), its /mnt/data/... path, its sandbox:/mnt/data/... path, its original file-... OpenAI file ID, or its cfile_... container file ID. Prefix and slash variations resolve to the same file.

Review or edit in GovTribe AI

Use the dedicated document pane for new human markup, review comments and edit requests. Agents use the native open_in_govtribe_ai tool and govtribe-document-editing skill with the appropriate file-format skill. An open request does not establish that the user reviewed or approved the file.

Show_Document no longer accepts annotation configuration or creates a separate inline review interface. Historical annotations are read-only, including pending drafts. Unsent marks are labeled separately and do not establish an edit request or approval. Submitted edit instructions remain available in their conversations and existing interaction state. External MCP clients retain read-only previews and authorized file links for use with their host's document workflow.

Access and preview failures

Both preview and URL refresh recheck file access. If a file is missing or unavailable to the user, the tool returns an error without new links. Current-conversation shell resolution still requires GovTribe AI context and an unambiguous file identifier. Unsupported file types and external-link files retain authorized download behavior without an inline viewer.

Show chart

Minimal: {"kind":"trend","rows":[{"month":"Jan","awards":3}],"labelKey":"month","series":[{"key":"awards"}]}. Render a read-only inline chart: `trend` renders 1–4 line series in supplied row order; `comparison` renders 1–4 grouped vertical bar series in supplied row order; `leaderboard` renders one horizontal bar series ranked descending. IDs and series labels default; titles, descriptions, colors, formatting and footnotes are optional. Descriptions appear once; omit them when no context is needed. Hover or focus a mark for its full label and value. Currency requires an explicit currency code; percent requires an explicit fraction/unit basis.

Show geo map

Minimal: {"series":[{"id":"offices","markers":[{"id":"office-1","lat":38.9,"lng":-77,"label":"Office"}]}]}. Display a simple map with marker popups and routes; it does not collect selections. Basemap access is configured by GovTribe, never supplied in tool arguments. Presentation ID and series labels default; descriptions, colors, styling, clustering and viewport options are optional. Preserve marker, series, route and record IDs. Use it for geographic review, not boundary-layer or heatmap analysis.

On this page

ExamplesPreview a government attachment and jump to evaluation criteriaPreview a generated shell artifactPayload patternsReview or edit in GovTribe AIAccess and preview failuresRelated articles