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, GovTribe Compact MCP server (through Invoke Search Tool)

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.

Identifier filters

Use govtribe_ids for GovTribe federal contract opportunity record IDs returned as govtribe_id. Use solicitation_numbers when the user gives federal solicitation numbers as public identifiers. The existing federal_contract_opportunity_ids field remains supported for GovTribe opportunity record IDs.

Use naics_codes and psc_codes when the user gives classification codes. federal_agency_ids expects GovTribe federal agency IDs, not agency codes.

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

{
  "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.

Lifecycle aggregations help summarize opportunity timing, status, type, and vehicle concentration before reading individual notices.

Aggregation	Use it to answer
`posted_date_histogram`	How many matching opportunities were posted in each month?
`due_date_histogram`	How many matching opportunities are due in each month?
`top_opportunity_states_by_doc_count`	Which opportunity statuses are most common in the scoped result set?
`top_opportunity_types_by_doc_count`	Which opportunity types are most common in the scoped result set?
`top_federal_contract_vehicles_by_doc_count`	Which federal contract vehicles are most represented in the scoped opportunity set?

Date histogram buckets are monthly. Use key_as_string for month labels and doc_count for the number of matching opportunities in that month.

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

Which active solicitations are due by month?

{
  "tool": "Search_Federal_Contract_Opportunities",
  "arguments": {
    "opportunity_types": [
      "Solicitation"
    ],
    "due_date_range": {
      "from": "now/d",
      "to": "now+12M/d"
    },
    "per_page": 0,
    "aggregations": [
      "due_date_histogram",
      "top_opportunity_states_by_doc_count"
    ]
  }
}

Which early notices were posted by month?

{
  "tool": "Search_Federal_Contract_Opportunities",
  "arguments": {
    "opportunity_types": [
      "Pre-Solicitation",
      "Special Notice"
    ],
    "posted_date": {
      "from": "now-12M/d",
      "to": "now/d"
    },
    "per_page": 0,
    "aggregations": [
      "posted_date_histogram",
      "top_opportunity_types_by_doc_count"
    ]
  }
}

What lifecycle mix does this opportunity market have?

{
  "tool": "Search_Federal_Contract_Opportunities",
  "arguments": {
    "query": "\"cybersecurity modernization\"",
    "search_mode": "keyword",
    "posted_date": {
      "from": "now-24M/d",
      "to": "now/d"
    },
    "per_page": 0,
    "aggregations": [
      "top_opportunity_types_by_doc_count",
      "top_opportunity_states_by_doc_count",
      "posted_date_histogram"
    ]
  }
}

Which federal contract vehicles are driving current opportunity activity?

{
  "tool": "Search_Federal_Contract_Opportunities",
  "arguments": {
    "query": "\"IT modernization\"",
    "search_mode": "keyword",
    "due_date_range": {
      "from": "now/d",
      "to": "now+12M/d"
    },
    "per_page": 0,
    "aggregations": [
      "top_federal_contract_vehicles_by_doc_count",
      "due_date_histogram"
    ]
  }
}

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 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 federal contract opportunities MCP tool

On this page