Show document MCP tool
Preview a GovTribe user file or government file in an interactive document viewer. Optionally enable document annotations so the user can mark up a WebViewer document and submit normalized annotation state back through Interaction_State without modifying the source file.
- MCP tool name:
Show_Document - Returns: Show document MCP response
- Annotations: Read only, not destructive, idempotent, closed world
- Surfaces: GovTribe AI, GovTribe MCP, GovTribe Compact MCP server
Examples
Use this to open exactly one GovTribe file or shell artifact in the document viewer.
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
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.
Enable human annotation review on a document
{
"tool": "Show_Document",
"arguments": {
"external_file_id": "<government_file_govtribe_id>",
"query": "key personnel",
"scroll_to_query": true,
"annotations": {
"enabled": true,
"tools": [
"highlight",
"note",
"rectangle"
],
"helperText": "Annotate the sections that need proposal-team follow-up.",
"submitLabel": "Submit annotations"
}
}
}Related articles
- Show document MCP response: Review the response shape returned by this tool.
- GovTribe AI: Review the GovTribe AI surface where this tool can be called.
- GovTribe for Agents: Use GovTribe for Agents as the starting point for MCP tools, MCP tool responses, and guides.
- MCP servers: Review where this MCP tool can be used.
- Source identifiers and record matching: Use GovTribe IDs and source identifiers when passing records between tools.
- Government file data type: Understand GovTribe-managed file records used by file and document tools.
- User file data type: Understand workspace-uploaded file records used by file and document tools.
Show chart
Render a read-only inline chart as a standard `trend`, `comparison`, or `leaderboard` view from structured rows and series data.
Show geo map
Render named marker series and routes in an interactive geo map, with optional clustering, marker styling, and marker selection that can be sent back to chat. Use it for interactive geographic review, not boundary-layer or heatmap analysis.