Search user files MCP tool

• MCP tool name: Search_User_Files
• Data type: User file data type
• Returns: User file MCP response
• Search modes: Keyword, Semantic
• Annotations: Read only, not destructive, idempotent, closed world
• Surfaces: GovTribe AI, GovTribe MCP, GovTribe Compact MCP server (through Invoke Search Tool)

Examples

Use these examples as task-shaped tool calls. Examples may combine query, search_mode, filters, sorting, returned fields, resolver calls, and aggregations. When an example resolves a related record first, pass the returned govtribe_id into the target search.

Which user files mention facility modernization?

{
  "tool": "Search_User_Files",
  "arguments": {
    "query": "facility modernization",
    "search_mode": "keyword",
    "fields_to_return": [
      "govtribe_id",
      "name",
      "description",
      "updated_at",
      "govtribe_ai_summary"
    ]
  }
}

Which user files exactly mention "technical support services"?

{
  "tool": "Search_User_Files",
  "arguments": {
    "query": "\"technical support services\"",
    "search_mode": "keyword",
    "fields_to_return": [
      "govtribe_id",
      "name",
      "description",
      "govtribe_ai_summary",
      "updated_at"
    ]
  }
}

Which user files are conceptually related to cybersecurity modernization?

{
  "tool": "Search_User_Files",
  "arguments": {
    "query": "cybersecurity modernization, zero trust upgrades, network defense services",
    "search_mode": "semantic",
    "fields_to_return": [
      "govtribe_id",
      "name",
      "govtribe_ai_summary",
      "description",
      "updated_at"
    ]
  }
}

Which of my files have I favorited?

Pass favorited: true to limit results to team files you have favorited. The filter scopes the favorite to you, not the file's uploader, so it can return a teammate's file that you saved. Records enter that list through Set favorite or the heart control in GovTribe Web. Only true is supported; omit the argument to search everything.

{
  "tool": "Search_User_Files",
  "arguments": {
    "favorited": true,
    "fields_to_return": [
      "govtribe_id",
      "name"
    ]
  }
}

Related articles

• User file MCP response: Review the response shape returned by this tool.
• User file data type: Understand the shared record fields and relationships used by this tool.
• Choose a search mode and write queries: Choose keyword or semantic search behavior and shape query values.
• 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.
• Invoke Search Tool MCP tool: Review where this MCP tool can be used.
• Source identifiers and record matching: Use GovTribe IDs and source identifiers when passing records between tools.