Search contract awards
search_contract_awardsUse this when the user wants government contracts search, federal contract awards by NAICS code, contracts expiring soon or federal market research. Queries live public award records and makes a multi-sheet Excel report with recipient and agency totals. At least one search filter; up to 300 rows, dates from 2007-10-01 through today UTC, prime contracts or IDVs. Totals cover returned rows; period obligations are separate aggregates. Do not use for open solicitations, bids, subcontracts or classified awards.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "search_contract_awards"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| states | No | Up to 10 values, each up to 2 characters. Example: ["TX"]. | |
| agencies | No | Up to 5 values, each up to 150 characters. Example: ["VA"]. | |
| end_date | No | Last action date, no later than today UTC; default today UTC. Example: 2026-10-01. | |
| keywords | No | Up to 5 values, each up to 50 characters. Example: ["janitorial"]. | |
| psc_codes | No | Up to 10 values, each up to 4 characters. Example: ["S201"]. | |
| recipients | No | Up to 10 values, each up to 80 characters. Example: ["Booz Allen"]. | |
| start_date | No | First action date, YYYY-MM-DD, from 2007-10-01. Default end minus 365 days. Example: 2025-10-01. | |
| max_results | No | Maximum award rows, 1 to 300, default 100. Example: 200. | |
| naics_codes | No | Up to 10 values, each up to 6 characters. Example: ["541512"]. | |
| award_category | No | Award group, default contracts. Example: idvs uses last date to order for the ending window. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| mode | Yes | ||
| notes | Yes | ||
| total | Yes | USD with two decimal places, for example $150.03 or -$40,013.22. | |
| awards | Yes | ||
| capped | Yes | ||
| ending | Yes | ||
| source | Yes | ||
| matched | Yes | ||
| summary | Yes | ||
| agencies | Yes | ||
| returned | Yes | ||
| downloads | Yes | ||
| recipients | Yes | ||
| competitors | Yes | ||
| ending_count | Yes | ||
| period_agencies | Yes | ||
| period_recipients | Yes | ||
| rows_without_amount | Yes |