Search GAO bid protests MCP tool
Searches GovTribe GAO bid protest records with file-number, agency, opportunity, protester, status, outcome, date, and procurement identifier filters.
- MCP tool name:
Search_GAO_Bid_Protests - Data type: GAO bid protest data type
- Returns: GAO bid protest 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)
Arguments
| Argument | Type | Required | Notes |
|---|---|---|---|
query | string | No | Accepted by the MCP tool schema. |
page | number | No | Defaults to 1. |
per_page | number | No | Defaults to 10. |
search_mode | string | No | Values: keyword, semantic Defaults to keyword. |
fields_to_return | string array | No | Accepted by the MCP tool schema. |
aggregations | string array | No | Accepted by the MCP tool schema. |
sort | object | No | Accepted by the MCP tool schema. |
Filters
| Filter | Type | Operators | Notes |
|---|---|---|---|
file_numbers | string array | in, not_in; default in | Filter by exact GAO file number. |
protesters | string array | in, not_in; default in | Filter by exact protester name. |
federal_agency_ids | string array | in, not_in; default in | Filter by federal agencies. Use GovTribe IDs or uniquely matching exact agency codes, canonical or alternate names, acronyms, and configured matching keys. |
federal_meta_opportunity_ids | string array | in, not_in; default in | Filter by federal meta opportunity IDs. These are GovTribe-derived linking IDs from federal contract opportunities. |
procurement_identifiers | string array | in, not_in; default in | Filter by exact procurement identifier, such as a solicitation number. |
case_types | string array | in, not_in; default in | Filter by GAO bid protest case type. |
statuses | string array | in, not_in; default in | Filter by GAO bid protest status. |
outcomes | string array | in, not_in; default in | Filter by GAO bid protest outcome. |
filed_date_range | object | Default | Filter by filed date. |
due_date_range | object | Default | Filter by due date. |
decision_date_range | object | Default | Filter by decision date. |
available_date_range | object | Default | Filter by available date. |
gao_bid_protest_ids | string array | in, not_in; default in | Include or exclude results by GovTribe IDs. |
govtribe_ids | string array | in, not_in; default in | Include or exclude results by GovTribe IDs. |
Sorts
| Sort | Default direction | Notes |
|---|---|---|
fileNumber | desc | Sort matching records by fileNumber. |
filedDate | desc | Sort matching records by filedDate. |
dueDate | desc | Sort matching records by dueDate. |
decisionDate | desc | Sort matching records by decisionDate. |
availableDate | desc | Sort matching records by availableDate. |
alphabeticalSort | desc | Sort matching records by alphabeticalSort. |
_score | desc | Sort matching records by _score. |
Available Fields
| Field | Attribute |
|---|---|
govtribe_id | GovTribe ID |
govtribe_type | GovTribe type |
govtribe_url | GovTribe URL |
file_number | File number |
name | Name |
protester | Protester |
case_type | Case type |
status | Status |
outcome | Outcome |
filed_date | Filed date |
due_date | Due date |
decision_date | Decision date |
available_date | Available date |
highlights | Highlights |
decision_text | Decision text |
pdf_url | PDF URL |
source_links | Source links |
procurement_identifiers | Procurement identifiers |
federal_agency | Federal agency |
federal_meta_opportunity_id | Federal meta opportunity ID |
federal_meta_opportunity | Federal meta opportunity |
Aggregations
Count-ranked leaders
| Aggregation | Use it to answer |
|---|---|
top_federal_agencies_by_doc_count | Which federal agencies appear most often in the matching protest set. |
top_case_types_by_doc_count | Which GAO bid protest case types are most common in the matching results. |
top_statuses_by_doc_count | Which protest statuses are most common, such as open or closed records. |
top_outcomes_by_doc_count | Which protest outcomes are most common for the filtered result set. |
top_linked_federal_meta_opportunities_by_doc_count | Which linked federal opportunity stacks have the most matching protest records. |
top_protesters_by_doc_count | Which protester names appear most often in the matching result set. |
top_procurement_identifiers_by_doc_count | Which procurement identifiers appear most often in the matching protest records. |
Related articles
- GAO bid protest MCP response: Review the response shape returned by this tool.
- GAO bid protest 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.
- 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 transactions
Searches federal contract award, IDV, assistance award, and contract/assistance subaward transactions. Use transaction_types to select families; omission includes all five. For prime contract spending select contract_award and contract_idv. NAICS and vendor filters do not establish a family. Statistics and dollar leaderboards sum signed total_value (federal plus non-federal value); dollar sorting uses federal_value. Subaward values are reported downstream amounts. Mixed prime/subaward sums are not unduplicated government spending, and award ceilings are not transaction obligations. Request transactions_by_type, positive_value_stats, and negative_value_stats for family counts/sums and separate signed values; zero and missing amounts enter neither sign group. Aggregations cover all filtered matches, independently of page size and the 10,000 hit-count threshold. Select transaction_type and parent_record to inspect the immediate parent; names and links depend on availability. Use transaction_date_range for transaction-period activity, transaction_effective_date_range for effective dates, and award_date_range for parent award-date cohorts. A 2022 award modified in 2025 belongs in the 2025 transaction period, not the 2025 award cohort.
Search government files
Search GovTribe government-file metadata, citable URLs, and available snippets/extracts. Use Add_To_Vector_Store, then Search_Vector_Store, when snippets are not enough and full-text retrieval is needed. Use Add_To_Container when a file must be available to hosted shell/container execution for analysis, generated artifacts, or direct file operations.