Search state and local contract opportunities MCP tool
Searches GovTribe state and local contract opportunities and returns solicitation records with schedules, contacts, and category tags.
- MCP tool name:
Search_State_And_Local_Contract_Opportunities - Data type: State and local contract opportunity data type
- Returns: State and local contract opportunity 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 opportunities mention facility modernization?
{
"tool": "Search_State_And_Local_Contract_Opportunities",
"arguments": {
"query": "facility modernization",
"search_mode": "keyword",
"fields_to_return": [
"govtribe_id",
"name",
"description",
"updated_at",
"govtribe_ai_summary"
]
}
}Which state and local contract opportunities exactly mention "technical support services"?
{
"tool": "Search_State_And_Local_Contract_Opportunities",
"arguments": {
"query": "\"technical support services\"",
"search_mode": "keyword",
"fields_to_return": [
"govtribe_id",
"name",
"description",
"solicitation_number",
"govtribe_ai_summary"
]
}
}Which state and local contract opportunities are conceptually related to cybersecurity modernization?
{
"tool": "Search_State_And_Local_Contract_Opportunities",
"arguments": {
"query": "cybersecurity modernization, zero trust upgrades, network defense services",
"search_mode": "semantic",
"fields_to_return": [
"govtribe_id",
"name",
"govtribe_ai_summary",
"description",
"posted_date"
]
}
}Which state and local opportunities are due in the next 12 months?
{
"tool": "Search_State_And_Local_Contract_Opportunities",
"arguments": {
"due_date_range": {
"from": "now/d",
"to": "now+12M/d"
},
"fields_to_return": [
"govtribe_id",
"name",
"govtribe_ai_summary",
"description",
"posted_date"
],
"sort": {
"key": "dueDate",
"direction": "asc"
}
}
}Which opportunities has my team not moved into capture work?
This example uses the authenticated GovTribe workspace context.
{
"tool": "Search_State_And_Local_Contract_Opportunities",
"arguments": {
"pursuing": false,
"fields_to_return": [
"govtribe_id",
"name",
"govtribe_ai_summary",
"description",
"posted_date"
]
}
}Which state and local opportunities list Bill Ingram as a contact?
{
"tool": "Search_Contacts",
"arguments": {
"query": "Bill Ingram",
"search_mode": "keyword",
"fields_to_return": [
"govtribe_id",
"name",
"organization"
]
}
}{
"tool": "Search_State_And_Local_Contract_Opportunities",
"arguments": {
"contact_ids": [
"<bill_ingram_govtribe_id>"
],
"fields_to_return": [
"govtribe_id",
"name",
"govtribe_ai_summary",
"description",
"posted_date"
]
}
}Which state and local opportunities are due soonest in the next 12 months?
{
"tool": "Search_State_And_Local_Contract_Opportunities",
"arguments": {
"due_date_range": {
"from": "now/d",
"to": "now+12M/d"
},
"fields_to_return": [
"govtribe_id",
"name",
"govtribe_ai_summary",
"description",
"posted_date"
],
"sort": {
"key": "dueDate",
"direction": "asc"
}
}
}Which opportunities are tied to Dallas County?
{
"tool": "Search_Jurisdictions",
"arguments": {
"query": "Dallas County",
"search_mode": "keyword",
"fields_to_return": [
"govtribe_id",
"name",
"fips_code"
]
}
}{
"tool": "Search_State_And_Local_Contract_Opportunities",
"arguments": {
"jurisdiction_ids": [
"<dallas_county_govtribe_id>"
],
"fields_to_return": [
"govtribe_id",
"name",
"govtribe_ai_summary",
"description",
"posted_date"
]
}
}Which opportunities are in 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_Opportunities",
"arguments": {
"nigp_category_ids": [
"<nigp_920_govtribe_id>"
],
"fields_to_return": [
"govtribe_id",
"name",
"govtribe_ai_summary",
"description",
"posted_date"
]
}
}Which state and local opportunities were posted in the last 30 days?
{
"tool": "Search_State_And_Local_Contract_Opportunities",
"arguments": {
"posted_date": {
"from": "now-30d/d",
"to": "now/d"
},
"fields_to_return": [
"govtribe_id",
"name",
"govtribe_ai_summary",
"description",
"posted_date"
]
}
}Which opportunities are already connected to pursuit work?
This example uses the authenticated GovTribe workspace context.
{
"tool": "Search_State_And_Local_Contract_Opportunities",
"arguments": {
"pursuing": true,
"fields_to_return": [
"govtribe_id",
"name",
"govtribe_ai_summary",
"description",
"posted_date"
]
}
}Which opportunities are in Texas?
{
"tool": "Search_States",
"arguments": {
"query": "Virginia",
"fields_to_return": [
"govtribe_id",
"name",
"usps_code"
]
}
}{
"tool": "Search_State_And_Local_Contract_Opportunities",
"arguments": {
"state_ids": [
"<virginia_govtribe_id>"
],
"fields_to_return": [
"govtribe_id",
"name",
"govtribe_ai_summary",
"description",
"posted_date"
]
}
}Which opportunities are in 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_Opportunities",
"arguments": {
"unspsc_category_ids": [
"<unspsc_43230000_govtribe_id>"
],
"fields_to_return": [
"govtribe_id",
"name",
"govtribe_ai_summary",
"description",
"posted_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.
Which categories define public safety software state and local contract opportunities?
{
"tool": "Search_State_And_Local_Contract_Opportunities",
"arguments": {
"query": "\"public safety software\"",
"per_page": 0,
"aggregations": [
"top_unspsc_codes_by_doc_count",
"top_nigp_codes_by_doc_count"
],
"search_mode": "keyword"
}
}Where are public safety software state and local contract opportunities concentrated?
{
"tool": "Search_State_And_Local_Contract_Opportunities",
"arguments": {
"query": "\"public safety software\"",
"per_page": 0,
"aggregations": [
"top_states_by_doc_count",
"top_jurisdictions_by_doc_count"
],
"search_mode": "keyword"
}
}Related articles
- State and local contract opportunity MCP response: Review the response shape returned by this tool.
- State and local contract opportunity 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
queryvalues. - 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
Searches GovTribe state and local contract IDVs and returns vehicle records with terms, awardees, and related awards.
Search state and local contract vehicles
Searches GovTribe state and local contract vehicles and returns vehicle records with scope, timelines, and related IDVs.