usa_expiring_awards
Pack: usaspending · Endpoint: https://gateway.pipeworx.io/usaspending/mcp
Federal contracts EXPIRING soon — the recompete calendar. “Which VA IT contracts over $10M expire in the next 12 months?” / “what is up for recompete at DHS next year” / “find follow-on opportunities in NAICS 5415” / “whose contract is ending”. Returns the incumbent holding each award, its period of performance, obligated dollars, agency, NAICS/PSC, and a usaspending.gov link. Filter by agency, sub-agency, NAICS or PSC prefix, incumbent name, and minimum obligated dollars. Covers awarded CONTRACTS already held by a vendor; for open solicitations still accepting bids use samgov/govcon tools.
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
agency | string | no | Awarding agency, substring match (e.g. “Department of Veterans Affairs”, “Defense”). |
sub_agency | string | no | Awarding sub-agency, substring match (e.g. “Veterans Health Administration”). |
naics | string | no | NAICS code or prefix. Hierarchical: “5415” matches all 6-digit computer-services codes beneath it. |
psc | string | no | Product/Service Code or prefix (e.g. “D3” for IT services). |
recipient | string | no | Incumbent contractor name, substring match. |
min_amount | number | no | Minimum total OBLIGATED dollars on the award (not the ceiling). 10000000 for “over $10M”. |
months_ahead | number | no | Window size in months from today (default 12). |
limit | number | no | Max awards to return (default 25, max 200). |
Example call
Arguments
{
"agency": "Department of Veterans Affairs",
"naics": "5415",
"min_amount": 10000000,
"months_ahead": 12
}
curl
curl -X POST https://gateway.pipeworx.io/usaspending/mcp \
-H 'Content-Type: application/json' \
-d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"usa_expiring_awards","arguments":{"agency":"Department of Veterans Affairs","naics":"5415","min_amount":10000000,"months_ahead":12}}}'
TypeScript (@pipeworx/sdk)
import { Pipeworx } from '@pipeworx/sdk';
const pipeworx = new Pipeworx();
const result = await pipeworx.call('usa_expiring_awards', {
"agency": "Department of Veterans Affairs",
"naics": "5415",
"min_amount": 10000000,
"months_ahead": 12
});
More examples
{
"agency": "Defense",
"months_ahead": 12,
"limit": 25
}
{
"recipient": "Leidos",
"months_ahead": 18
}
Connect
Add this to your MCP client config, or use one-click install buttons:
{
"mcpServers": {
"usaspending": {
"url": "https://gateway.pipeworx.io/usaspending/mcp"
}
}
}
See Getting Started for client-specific install steps.