GovTribe

Refresh document MCP tool

Refreshes expiring preview and download URLs for the show document widget.

Examples

Use this when an existing document viewer needs fresh preview or download URLs.

Refresh a government file preview and keep the same highlighted clause

{
  "tool": "Refresh_Show_Document",
  "arguments": {
    "external_file_id": "<government_file_govtribe_id>",
    "query": "evaluation criteria",
    "scroll_to_query": true
  }
}

Refresh a shell artifact preview

{
  "tool": "Refresh_Show_Document",
  "arguments": {
    "shell_file_identifier": "sandbox:/mnt/data/compliance-matrix.xlsx",
    "query": "Section L",
    "scroll_to_query": false
  }
}

Payload patterns

{
  "tool": "Refresh_Show_Document",
  "arguments": {
    "external_file_id": "<government_file_govtribe_id>"
  }
}

Pass exactly one file identifier: user_file_id, external_file_id, or shell_file_identifier.

The widget refreshes expired URLs at initial load and when Download is selected after a mounted preview outlives its links. It uses the same authorized file identifier, query and scroll preference. Duplicate pending clicks share one refresh. A failed, denied or stale refresh never opens an expired URL. A refresh does not create annotation state. Do not send annotations configuration. Existing historical annotation state is restored separately through Interaction_State.

If access has been revoked or the file no longer exists, refresh returns an error. The widget does not fall back to expired links. Files without an inline preview retain authorized download behavior after refresh.