Update pursuit MCP tool

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

Examples

Resolve the pursuit first, and resolve a destination stage if the update moves the pursuit. If you include tag_ids, the provided array replaces the pursuit's full tag set; omit tag_ids to leave tags unchanged. custom_fields works differently: only the listed custom fields change, and a null value clears one.

Update pursuit value and probability of win

{
  "tool": "Search_Pursuits",
  "arguments": {
    "query": "facility modernization capture",
    "fields_to_return": [
      "govtribe_id",
      "name",
      "estimated_value",
      "stage",
      "pipeline"
    ]
  }
}

{
  "tool": "Update_Pursuit",
  "arguments": {
    "pursuit_id": "<pursuit_govtribe_id>",
    "name": "Facility modernization capture",
    "description": "Updated after review of the solicitation attachments and incumbent context.",
    "pwin": 45,
    "estimated_value": 3200000,
    "estimated_duration": 36,
    "estimated_award_date": "2026-09-30",
    "due_date": "2026-06-15",
    "tag_ids": [
      "<tag_govtribe_id>"
    ]
  }
}

Move a pursuit to another stage

{
  "tool": "Search_Stages",
  "arguments": {
    "query": "Pursue",
    "fields_to_return": [
      "govtribe_id",
      "name",
      "pipeline"
    ]
  }
}

{
  "tool": "Update_Pursuit",
  "arguments": {
    "pursuit_id": "<pursuit_govtribe_id>",
    "stage_id": "<stage_govtribe_id>"
  }
}

Set custom field values

Resolve custom_field_id values with Search custom field definitions. custom_fields merges by id: only the listed fields change, unlike tag_ids. Send a string for text, a number (decimals allowed) for number and dollar, and an ISO 8601 date for date; a date-only value such as 2026-09-02 is stored as UTC midnight. Send null to clear a field. Objects returned in a pursuit's custom_fields can be sent back as they are; name and field_type are ignored on write, and a blank or whitespace-only value clears the field like null.

{
  "tool": "Update_Pursuit",
  "arguments": {
    "pursuit_id": "<pursuit_govtribe_id>",
    "custom_fields": [
      {
        "custom_field_id": "<custom_field_definition_govtribe_id>",
        "value": 1250000.5
      },
      {
        "custom_field_id": "<date_custom_field_definition_govtribe_id>",
        "value": "2026-09-02"
      }
    ]
  }
}

Related articles

• Pursuit MCP response: Review the response shape returned by this tool.
• Pursuit 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.