Update saved search MCP tool

• MCP tool name: Update_Saved_Search
• Data type: Saved search data type
• Returns: Saved search MCP response
• Annotations: Not read only, destructive, idempotent, closed world
• Surfaces: GovTribe AI, GovTribe MCP, GovTribe Compact MCP server

Examples

Resolve the saved search before changing its name, notification cadence, or stored criteria. To replace criteria, run or refine the matching Search_* tool first and use the returned search_results_id.

Change a saved search to instant alerts

{
  "tool": "Search_Saved_Searches",
  "arguments": {
    "query": "Cybersecurity operations opportunities",
    "fields_to_return": [
      "govtribe_id",
      "name",
      "frequency",
      "search_results_id"
    ]
  }
}

{
  "tool": "Update_Saved_Search",
  "arguments": {
    "saved_search_id": "<saved_search_govtribe_id>",
    "name": "Cybersecurity operations recompetes",
    "frequency": "Instant"
  }
}

Set frequency to Never to stop saved-search email.

Saved-search frequency changes do not update the polling frequency of automations that use this saved search.

Replace saved search criteria with a refined search

{
  "tool": "Search_Federal_Contract_Opportunities",
  "arguments": {
    "query": "cybersecurity operations",
    "due_date_range": {
      "from": "2026-07-01",
      "to": null
    },
    "fields_to_return": [
      "govtribe_id",
      "name"
    ]
  }
}

{
  "tool": "Update_Saved_Search",
  "arguments": {
    "saved_search_id": "<saved_search_govtribe_id>",
    "search_results_id": "<search_results_id>"
  }
}

The saved search keeps its saved-search ID and adopts the recent search's query, filters, sorts, source search type, and search mode.

Related articles

• Saved search MCP response: Review the response shape returned by this tool.
• Saved search data type: Understand the shared record fields and relationships used 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.