GovTribe

Search state and local contract vehicles MCP tool

Searches GovTribe state and local contract vehicles and returns vehicle records with scope, timelines, and related IDVs.

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 state and local contract vehicles mention facility modernization?

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

Which state and local contract vehicles exactly mention "technical support services"?

{
  "tool": "Search_State_And_Local_Contract_Vehicles",
  "arguments": {
    "query": "\"technical support services\"",
    "search_mode": "keyword",
    "fields_to_return": [
      "govtribe_id",
      "name",
      "description",
      "govtribe_ai_summary",
      "award_date"
    ]
  }
}
{
  "tool": "Search_State_And_Local_Contract_Vehicles",
  "arguments": {
    "query": "cybersecurity modernization, zero trust upgrades, network defense services",
    "search_mode": "semantic",
    "fields_to_return": [
      "govtribe_id",
      "name",
      "govtribe_ai_summary",
      "description",
      "award_date"
    ]
  }
}

Which state and local vehicles were awarded in the last 12 months?

{
  "tool": "Search_State_And_Local_Contract_Vehicles",
  "arguments": {
    "award_date_range": {
      "from": "now-12M/d",
      "to": "now/d"
    },
    "fields_to_return": [
      "govtribe_id",
      "name",
      "govtribe_ai_summary",
      "description",
      "award_date"
    ],
    "sort": {
      "key": "awardDate",
      "direction": "desc"
    }
  }
}

Which state and local vehicles has my team not moved into capture work?

This example uses the authenticated GovTribe workspace context.

{
  "tool": "Search_State_And_Local_Contract_Vehicles",
  "arguments": {
    "pursuing": false,
    "fields_to_return": [
      "govtribe_id",
      "name",
      "govtribe_ai_summary",
      "description",
      "award_date"
    ]
  }
}

Which state and local vehicles were awarded in the last 12 months using Award Date?

{
  "tool": "Search_State_And_Local_Contract_Vehicles",
  "arguments": {
    "award_date_range": {
      "from": "now-12M/d",
      "to": "now/d"
    },
    "fields_to_return": [
      "govtribe_id",
      "name",
      "govtribe_ai_summary",
      "description",
      "award_date"
    ],
    "sort": {
      "key": "awardDate",
      "direction": "desc"
    }
  }
}

Which vehicles are connected to Chad Keech?

{
  "tool": "Search_Contacts",
  "arguments": {
    "query": "Chad Keech",
    "search_mode": "keyword",
    "fields_to_return": [
      "govtribe_id",
      "name",
      "organization"
    ]
  }
}
{
  "tool": "Search_State_And_Local_Contract_Vehicles",
  "arguments": {
    "contact_ids": [
      "<chad_keech_govtribe_id>"
    ],
    "fields_to_return": [
      "govtribe_id",
      "name",
      "govtribe_ai_summary",
      "description",
      "award_date"
    ]
  }
}

Which vehicles are tied to Operational Services Division?

{
  "tool": "Search_State_And_Local_Contract_Vehicles",
  "arguments": {
    "contract_entities": [
      "Operational Services Division"
    ],
    "fields_to_return": [
      "govtribe_id",
      "name",
      "govtribe_ai_summary",
      "description",
      "award_date"
    ]
  }
}

Which state and local vehicles are tied to NIGP 920?

{
  "tool": "Search_Nigp_Categories",
  "arguments": {
    "query": "920",
    "search_mode": "keyword",
    "fields_to_return": [
      "govtribe_id",
      "code",
      "name"
    ]
  }
}
{
  "tool": "Search_State_And_Local_Contract_Vehicles",
  "arguments": {
    "nigp_category_ids": [
      "<nigp_920_govtribe_id>"
    ],
    "fields_to_return": [
      "govtribe_id",
      "name",
      "govtribe_ai_summary",
      "description",
      "award_date"
    ]
  }
}

Which vehicles may end in a target completion window?

{
  "tool": "Search_State_And_Local_Contract_Vehicles",
  "arguments": {
    "potential_completion_date_range": {
      "from": "now/d",
      "to": "now+12M/d"
    },
    "fields_to_return": [
      "govtribe_id",
      "name",
      "govtribe_ai_summary",
      "description",
      "award_date"
    ],
    "sort": {
      "key": "potentialCompletionDate",
      "direction": "asc"
    }
  }
}

Which vehicles are already connected to pursuit work?

This example uses the authenticated GovTribe workspace context.

{
  "tool": "Search_State_And_Local_Contract_Vehicles",
  "arguments": {
    "pursuing": true,
    "fields_to_return": [
      "govtribe_id",
      "name",
      "govtribe_ai_summary",
      "description",
      "award_date"
    ]
  }
}

Which state and local vehicles are tied to Florida?

{
  "tool": "Search_States",
  "arguments": {
    "query": "Florida",
    "fields_to_return": [
      "govtribe_id",
      "name",
      "usps_code"
    ]
  }
}
{
  "tool": "Search_State_And_Local_Contract_Vehicles",
  "arguments": {
    "state_ids": [
      "<florida_govtribe_id>"
    ],
    "fields_to_return": [
      "govtribe_id",
      "name",
      "govtribe_ai_summary",
      "description",
      "award_date"
    ]
  }
}

Which state and local vehicles are tied to UNSPSC 43230000?

{
  "tool": "Search_Unspsc_Categories",
  "arguments": {
    "query": "43230000",
    "search_mode": "keyword",
    "fields_to_return": [
      "govtribe_id",
      "code",
      "name"
    ]
  }
}
{
  "tool": "Search_State_And_Local_Contract_Vehicles",
  "arguments": {
    "unspsc_category_ids": [
      "<unspsc_43230000_govtribe_id>"
    ],
    "fields_to_return": [
      "govtribe_id",
      "name",
      "govtribe_ai_summary",
      "description",
      "award_date"
    ]
  }
}

Aggregation examples

Use aggregation examples when the answer needs rollups instead of individual rows. These examples use quoted keyword anchors in query so long-tail matches do not skew buckets; broaden the query only when the user asks for exploratory sizing, and pair broader queries with structured filters when possible. Set per_page to 0 when row results are not needed.

How large is the public safety software state and local contract vehicles set?

{
  "tool": "Search_State_And_Local_Contract_Vehicles",
  "arguments": {
    "query": "\"public safety software\"",
    "per_page": 0,
    "aggregations": [
      "dollars_obligated_stats"
    ],
    "search_mode": "keyword"
  }
}

Which organizations are most represented among public safety software state and local contract vehicles?

{
  "tool": "Search_State_And_Local_Contract_Vehicles",
  "arguments": {
    "query": "\"public safety software\"",
    "per_page": 0,
    "aggregations": [
      "top_contract_entities_by_dollars_obligated"
    ],
    "search_mode": "keyword"
  }
}

Which categories define public safety software state and local contract vehicles?

{
  "tool": "Search_State_And_Local_Contract_Vehicles",
  "arguments": {
    "query": "\"public safety software\"",
    "per_page": 0,
    "aggregations": [
      "top_nigp_codes_by_dollars_obligated",
      "top_unspsc_codes_by_dollars_obligated",
      "top_unspsc_codes_by_doc_count",
      "top_nigp_codes_by_doc_count"
    ],
    "search_mode": "keyword"
  }
}

Where are public safety software state and local contract vehicles concentrated?

{
  "tool": "Search_State_And_Local_Contract_Vehicles",
  "arguments": {
    "query": "\"public safety software\"",
    "per_page": 0,
    "aggregations": [
      "top_states_by_dollars_obligated",
      "top_states_by_doc_count"
    ],
    "search_mode": "keyword"
  }
}