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.

MCP tool name: Search_State_And_Local_Contract_Vehicles
Data type: State and local contract vehicle data type
Returns: State and local contract vehicle 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

Include contract_number in fields_to_return to return the vehicle’s contract number with its original formatting. If the original is missing, the value falls back to the normalized identifier; if no number is stored, it returns null.

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",
      "contract_number",
      "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?

Filtering by nigp_category_ids matches every NIGP category stored on a record. Each returned record's nigp_categories lists at most 10 of its categories, in stored order, so it may not include the filtered category.

{
  "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",
      "nigp_categories"
    ]
  }
}

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?

Filtering by unspsc_category_ids matches every UNSPSC category stored on a record. Each returned record's unspsc_categories lists at most 10 of its categories, in stored order, so it may not include the filtered category.

{
  "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",
      "unspsc_categories"
    ]
  }
}

Which state and local contract vehicles have I favorited?

Pass favorited: true to limit results to state and local vehicles you flagged. 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_State_And_Local_Contract_Vehicles",
  "arguments": {
    "favorited": true,
    "fields_to_return": [
      "govtribe_id",
      "name"
    ]
  }
}

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"
  }
}

State and local contract vehicle MCP response: Review the response shape returned by this tool.
State and local contract vehicle 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.

Search state and local contract vehicles MCP tool

On this page