Search state and local contract awards MCP tool

Searches GovTribe state and local contract awards and returns award records with values, winners, and supporting materials.

MCP tool name: Search_State_And_Local_Contract_Awards
Data type: State and local contract award data type
Returns: State and local contract award 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 awards mention facility modernization?

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

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

{
  "tool": "Search_State_And_Local_Contract_Awards",
  "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_Awards",
  "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 awards were made in the last 12 months?

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

This example uses the authenticated GovTribe workspace context.

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

Which state and local awards were made in the last 12 months using Award Date?

{
  "tool": "Search_State_And_Local_Contract_Awards",
  "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 awards are connected to a specific state or local contact?

{
  "tool": "Search_Contacts",
  "arguments": {
    "query": "Joey De Los Reyes",
    "search_mode": "keyword",
    "fields_to_return": [
      "govtribe_id",
      "name",
      "organization"
    ]
  }
}

{
  "tool": "Search_State_And_Local_Contract_Awards",
  "arguments": {
    "contact_ids": [
      "<joey_de_los_reyes_govtribe_id>"
    ],
    "fields_to_return": [
      "govtribe_id",
      "name",
      "govtribe_ai_summary",
      "description",
      "award_date"
    ]
  }
}

Which awards are tied to Engineering - Construction contract entities?

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

Which awards 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_Awards",
  "arguments": {
    "nigp_category_ids": [
      "<nigp_920_govtribe_id>"
    ],
    "fields_to_return": [
      "govtribe_id",
      "name",
      "govtribe_ai_summary",
      "description",
      "award_date"
    ]
  }
}

Which awards may end in a target completion window?

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

This example uses the authenticated GovTribe workspace context.

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

Which state and local awards are tied to Florida?

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

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

Which awards are tied to a known parent state and local IDV?

{
  "tool": "Search_State_And_Local_Contract_IDVs",
  "arguments": {
    "query": "state local IDV",
    "search_mode": "keyword",
    "fields_to_return": [
      "govtribe_id",
      "name"
    ]
  }
}

{
  "tool": "Search_State_And_Local_Contract_Awards",
  "arguments": {
    "state_local_contract_idv_ids": [
      "<state_local_idv_govtribe_id>"
    ],
    "fields_to_return": [
      "govtribe_id",
      "name",
      "govtribe_ai_summary",
      "description",
      "award_date"
    ]
  }
}

Which awards 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_Awards",
  "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 awards set?

{
  "tool": "Search_State_And_Local_Contract_Awards",
  "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 awards?

{
  "tool": "Search_State_And_Local_Contract_Awards",
  "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 awards?

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

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

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

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

On this page