Create pursuit MCP tool
Creates a new pursuit in the specified stage, optionally seeding fields from a linked item.
- MCP tool name:
Create_Pursuit - Data type: Pursuit data type
- Returns: Pursuit MCP response
- Annotations: Not read only, not destructive, not idempotent, closed world
- Surfaces: GovTribe AI, GovTribe MCP, GovTribe Compact MCP server
Examples
Resolve the destination stage first, then create the pursuit in that stage. Include tag_ids to set workspace tags when the pursuit is created, and custom_fields to fill in workspace custom fields.
Create a pursuit in the qualification stage
{
"tool": "Search_Stages",
"arguments": {
"query": "Qualification",
"fields_to_return": [
"govtribe_id",
"name",
"pipeline"
]
}
}{
"tool": "Create_Pursuit",
"arguments": {
"stage_id": "<qualification_stage_govtribe_id>",
"name": "Facility modernization capture",
"description": "Assess fit, incumbent signals, and near-term response requirements.",
"pwin": 35,
"estimated_value": 2500000,
"estimated_duration": 36,
"estimated_award_date": "2026-09-30",
"due_date": "2026-06-15",
"tag_ids": [
"<tag_govtribe_id>"
]
}
}Create a pursuit from a linked federal opportunity
{
"tool": "Search_Federal_Contract_Opportunities",
"arguments": {
"query": "facility modernization",
"search_mode": "semantic",
"fields_to_return": [
"govtribe_id",
"name",
"due_date"
]
}
}{
"tool": "Create_Pursuit",
"arguments": {
"stage_id": "<target_stage_govtribe_id>",
"linked_item_model_class": "FederalContractOpportunityModel",
"linked_item_id": "<federal_contract_opportunity_govtribe_id>",
"pwin": 40
}
}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": "Create_Pursuit",
"arguments": {
"stage_id": "<stage_govtribe_id>",
"name": "Facility modernization capture",
"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.