Search state and local contract IDVs MCP tool

Searches GovTribe state and local contract IDVs and returns vehicle records with terms, awardees, and related awards.

MCP tool name: Search_State_And_Local_Contract_IDVs
Data type: State and local contract IDV data type
Returns: State and local contract IDV MCP response
Search modes: Keyword, Semantic
Annotations: Read only, not destructive, idempotent, closed world
Surfaces: GovTribe AI, GovTribe MCP

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 IDVs mention facility modernization?

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

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

{
  "tool": "Search_State_And_Local_Contract_IDVs",
  "arguments": {
    "query": "\"technical support services\"",
    "search_mode": "keyword",
    "fields_to_return": [
      "govtribe_id",
      "name",
      "description",
      "contract_number",
      "govtribe_ai_summary"
    ]
  }
}

{
  "tool": "Search_State_And_Local_Contract_IDVs",
  "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 IDVs were awarded in the last 12 months?

{
  "tool": "Search_State_And_Local_Contract_IDVs",
  "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 IDVs has my team not moved into capture work?

This example uses the authenticated GovTribe workspace context.

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

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

{
  "tool": "Search_State_And_Local_Contract_IDVs",
  "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 IDVs 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_IDVs",
  "arguments": {
    "nigp_category_ids": [
      "<nigp_920_govtribe_id>"
    ],
    "fields_to_return": [
      "govtribe_id",
      "name",
      "govtribe_ai_summary",
      "description",
      "award_date"
    ]
  }
}

Which IDVs may end in a target completion window?

{
  "tool": "Search_State_And_Local_Contract_IDVs",
  "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 IDVs are already connected to pursuit work?

This example uses the authenticated GovTribe workspace context.

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

Which state and local IDVs are tied to Florida?

{
  "tool": "Search_States",
  "arguments": {
    "query": "Florida",
    "fields_to_return": [
      "govtribe_id",
      "name",
      "usps_code"
    ]
  }
}

{
  "tool": "Search_State_And_Local_Contract_IDVs",
  "arguments": {
    "state_ids": [
      "<florida_govtribe_id>"
    ],
    "fields_to_return": [
      "govtribe_id",
      "name",
      "govtribe_ai_summary",
      "description",
      "award_date"
    ]
  }
}

Which IDVs are connected to a known parent vehicle?

{
  "tool": "Search_State_And_Local_Contract_Vehicles",
  "arguments": {
    "query": "Operational Services Division",
    "search_mode": "keyword",
    "fields_to_return": [
      "govtribe_id",
      "name"
    ]
  }
}

{
  "tool": "Search_State_And_Local_Contract_IDVs",
  "arguments": {
    "state_local_contract_vehicle_ids": [
      "<operational_services_division_vehicle_govtribe_id>"
    ],
    "fields_to_return": [
      "govtribe_id",
      "name",
      "govtribe_ai_summary",
      "description",
      "award_date"
    ]
  }
}

Which state and local IDVs 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_IDVs",
  "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 IDVs set?

{
  "tool": "Search_State_And_Local_Contract_IDVs",
  "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 IDVs?

{
  "tool": "Search_State_And_Local_Contract_IDVs",
  "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 IDVs?

{
  "tool": "Search_State_And_Local_Contract_IDVs",
  "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 IDVs concentrated?

{
  "tool": "Search_State_And_Local_Contract_IDVs",
  "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 IDV MCP response: Review the response shape returned by this tool.
State and local contract IDV 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.
Source identifiers and record matching: Use GovTribe IDs and source identifiers when passing records between tools.

Search state and local contract IDVs MCP tool

On this page