Search federal contract opportunities MCP tool
Searches GovTribe federal contract opportunities and returns solicitation records with requirements, timelines, files, and contacts.
- MCP tool name:
Search_Federal_Contract_Opportunities - Data type: Federal contract opportunity data type
- Returns: Federal 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 federal contract opportunities mention facility modernization?
{
"tool": "Search_Federal_Contract_Opportunities",
"arguments": {
"query": "facility modernization",
"search_mode": "keyword",
"fields_to_return": [
"govtribe_id",
"name",
"descriptions",
"updated_at",
"govtribe_ai_summary"
]
}
}Which federal contract opportunities exactly mention "technical support services"?
{
"tool": "Search_Federal_Contract_Opportunities",
"arguments": {
"query": "\"technical support services\"",
"search_mode": "keyword",
"fields_to_return": [
"govtribe_id",
"name",
"descriptions",
"solicitation_number",
"govtribe_ai_summary"
]
}
}Which federal contract opportunities are conceptually related to cybersecurity modernization?
{
"tool": "Search_Federal_Contract_Opportunities",
"arguments": {
"query": "cybersecurity modernization, zero trust upgrades, network defense services",
"search_mode": "semantic",
"fields_to_return": [
"govtribe_id",
"name",
"govtribe_ai_summary",
"descriptions",
"award_date"
]
}
}Which federal contract opportunities are due in the next 12 months?
{
"tool": "Search_Federal_Contract_Opportunities",
"arguments": {
"due_date_range": {
"from": "now/d",
"to": "now+12M/d"
},
"fields_to_return": [
"govtribe_id",
"name",
"govtribe_ai_summary",
"descriptions",
"award_date"
],
"sort": {
"key": "dueDate",
"direction": "asc"
}
}
}Which federal contract opportunities do not list a set-aside?
{
"tool": "Search_Federal_Contract_Opportunities",
"arguments": {
"set_aside_types": [
"No Set-Aside Used"
],
"fields_to_return": [
"govtribe_id",
"name",
"govtribe_ai_summary",
"descriptions",
"award_date"
]
}
}Which opportunities has my team not moved into capture work?
This example uses the authenticated GovTribe workspace context.
{
"tool": "Search_Federal_Contract_Opportunities",
"arguments": {
"pursuing": false,
"fields_to_return": [
"govtribe_id",
"name",
"govtribe_ai_summary",
"descriptions",
"award_date"
]
}
}Which opportunities have a listed or expected award date in the target window?
{
"tool": "Search_Federal_Contract_Opportunities",
"arguments": {
"award_date_range": {
"from": "now-12M/d",
"to": "now/d"
},
"fields_to_return": [
"govtribe_id",
"name",
"govtribe_ai_summary",
"descriptions",
"award_date"
],
"sort": {
"key": "awardDate",
"direction": "desc"
}
}
}Which opportunities list MRR Procurement Mailbox as a contact?
{
"tool": "Search_Contacts",
"arguments": {
"query": "MRR Procurement Mailbox",
"search_mode": "keyword",
"fields_to_return": [
"govtribe_id",
"name",
"organization"
]
}
}{
"tool": "Search_Federal_Contract_Opportunities",
"arguments": {
"contact_ids": [
"<mrr_procurement_mailbox_govtribe_id>"
],
"fields_to_return": [
"govtribe_id",
"name",
"govtribe_ai_summary",
"descriptions",
"award_date"
]
}
}Which notices are due soonest in the next 12 months?
{
"tool": "Search_Federal_Contract_Opportunities",
"arguments": {
"due_date_range": {
"from": "now/d",
"to": "now+12M/d"
},
"fields_to_return": [
"govtribe_id",
"name",
"govtribe_ai_summary",
"descriptions",
"award_date"
],
"sort": {
"key": "dueDate",
"direction": "asc"
}
}
}Which opportunities are tied to Department of the Navy?
{
"tool": "Search_Federal_Agencies",
"arguments": {
"query": "Department of the Navy",
"search_mode": "keyword",
"fields_to_return": [
"govtribe_id",
"name",
"acronym"
]
}
}{
"tool": "Search_Federal_Contract_Opportunities",
"arguments": {
"federal_agency_ids": [
"<department_of_the_navy_govtribe_id>"
],
"fields_to_return": [
"govtribe_id",
"name",
"govtribe_ai_summary",
"descriptions",
"award_date"
]
}
}Which opportunities are connected to Multiple Award Schedule?
{
"tool": "Search_Federal_Contract_Vehicles",
"arguments": {
"query": "Multiple Award Schedule",
"search_mode": "keyword",
"fields_to_return": [
"govtribe_id",
"name"
]
}
}{
"tool": "Search_Federal_Contract_Opportunities",
"arguments": {
"federal_contract_vehicle_ids": [
"<multiple_award_schedule_govtribe_id>"
],
"fields_to_return": [
"govtribe_id",
"name",
"govtribe_ai_summary",
"descriptions",
"award_date"
]
}
}Which opportunities are in NAICS 541512?
{
"tool": "Search_Naics_Categories",
"arguments": {
"query": "541512",
"search_mode": "keyword",
"fields_to_return": [
"govtribe_id",
"code",
"name"
]
}
}{
"tool": "Search_Federal_Contract_Opportunities",
"arguments": {
"naics_category_ids": [
"<naics_541512_govtribe_id>"
],
"fields_to_return": [
"govtribe_id",
"name",
"govtribe_ai_summary",
"descriptions",
"award_date"
]
}
}Which national stock number category is connected to the opportunity?
{
"tool": "Search_Federal_Contract_Opportunities",
"arguments": {
"nsn_category_ids": [
"123456789"
],
"fields_to_return": [
"govtribe_id",
"name",
"govtribe_ai_summary",
"descriptions",
"award_date"
]
}
}Which opportunities are currently awarded?
{
"tool": "Search_Federal_Contract_Opportunities",
"arguments": {
"opportunity_states": [
"Awarded"
],
"fields_to_return": [
"govtribe_id",
"name",
"govtribe_ai_summary",
"descriptions",
"award_date"
]
}
}Which opportunities are solicitations?
{
"tool": "Search_Federal_Contract_Opportunities",
"arguments": {
"opportunity_types": [
"Solicitation"
],
"fields_to_return": [
"govtribe_id",
"name",
"govtribe_ai_summary",
"descriptions",
"award_date"
]
}
}Which opportunities are in PSC R499?
{
"tool": "Search_Psc_Categories",
"arguments": {
"query": "R499",
"search_mode": "keyword",
"fields_to_return": [
"govtribe_id",
"code",
"name"
]
}
}{
"tool": "Search_Federal_Contract_Opportunities",
"arguments": {
"psc_category_ids": [
"<psc_r499_govtribe_id>"
],
"fields_to_return": [
"govtribe_id",
"name",
"govtribe_ai_summary",
"descriptions",
"award_date"
]
}
}Which opportunities are performed in Virginia?
{
"tool": "Search_Federal_Contract_Opportunities",
"arguments": {
"place_of_performance_ids": [
"Virginia"
],
"fields_to_return": [
"govtribe_id",
"name",
"govtribe_ai_summary",
"descriptions",
"award_date"
]
}
}Which opportunities were posted in the last 30 days?
{
"tool": "Search_Federal_Contract_Opportunities",
"arguments": {
"posted_date": {
"from": "now-30d/d",
"to": "now/d"
},
"fields_to_return": [
"govtribe_id",
"name",
"govtribe_ai_summary",
"descriptions",
"award_date"
]
}
}Which opportunities are already connected to pursuit work?
This example uses the authenticated GovTribe workspace context.
{
"tool": "Search_Federal_Contract_Opportunities",
"arguments": {
"pursuing": true,
"fields_to_return": [
"govtribe_id",
"name",
"govtribe_ai_summary",
"descriptions",
"award_date"
]
}
}Which opportunities have No Set-Aside Used?
{
"tool": "Search_Federal_Contract_Opportunities",
"arguments": {
"set_aside_types": [
"No Set-Aside Used"
],
"fields_to_return": [
"govtribe_id",
"name",
"govtribe_ai_summary",
"descriptions",
"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.
Which organizations are most represented among cybersecurity modernization federal contract opportunities?
{
"tool": "Search_Federal_Contract_Opportunities",
"arguments": {
"query": "\"cybersecurity modernization\"",
"per_page": 0,
"aggregations": [
"top_federal_agencies_by_doc_count",
"top_contacts_by_doc_count"
],
"search_mode": "keyword"
}
}Which categories define cybersecurity modernization federal contract opportunities?
{
"tool": "Search_Federal_Contract_Opportunities",
"arguments": {
"query": "\"cybersecurity modernization\"",
"per_page": 0,
"aggregations": [
"top_set_aside_types_by_doc_count",
"top_naics_codes_by_doc_count",
"top_psc_codes_by_doc_count"
],
"search_mode": "keyword"
}
}Where are cybersecurity modernization federal contract opportunities concentrated?
{
"tool": "Search_Federal_Contract_Opportunities",
"arguments": {
"query": "\"cybersecurity modernization\"",
"per_page": 0,
"aggregations": [
"top_locations_by_doc_count"
],
"search_mode": "keyword"
}
}Related articles
- Federal contract opportunity MCP response: Review the response shape returned by this tool.
- Federal 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 federal contract IDVs
Searches GovTribe federal contract IDVs and returns vehicle records with ceilings, awardees, agencies, and related awards.
Search federal contract sub awards
Searches GovTribe federal contract sub-awards and returns subcontract records with amounts, primes, subs, and agency context.