U.S. Federal Contract Awards Search (Recipient, Amount, Agency, Dates)
usaspending/contract-awards
Searches U.S. federal contract awards (purchase orders, delivery orders, definitive contracts and BPA calls) on USAspending.gov by keyword, recipient name, awarding agency, award id and a date window, and returns each award's recipient, its UEI, award amount, total outlays, description, start and end dates, awarding agency and sub-agency, contract type and NAICS code. Award Amount is the award's lifetime obligation to date, not what was spent inside the window; Total Outlays is null until the agency reports cash paid. By default only awards first signed inside the window are returned. Data is the U.S. Treasury's USAspending.gov (Bureau of the Fiscal Service); recipient names and addresses may be Dun & Bradstreet Open Data, attributed to D&B.
activeper callv1
Price
$0.0026 per call
You pay the price shown. If a call turns out to cost more than its quote, you pay the actual price, capped at twice the quote. No monthly minimum. Top-ups start at $5.
Data source
Data from USAspending.gov, U.S. Department of the Treasury, Bureau of the Fiscal Service (usaspending.gov), available for commercial and non-commercial use per usaspending.gov/about. Recipient names and addresses may be Dun & Bradstreet, Inc. Open Data, attributed to D&B.
Use it
Five steps: search, inspect, learn, run, settle. No per-tool setup; your agent reaches this tool through the meta-tools it already has.
Connect once and your AI can find and run this tool, and any other it needs.
agent
// 1. search: find the tool
omnial_search({ query: "what you need" })
// 2. inspect: price and input schema
omnial_inspect({ tool: "usaspending/contract-awards" })
// 3. learn: read the usage guide at runtime
omnial_learn({ tool: "usaspending/contract-awards" })
// 4. run: price the exact call first, then run it
omnial_execute({ tool: "usaspending/contract-awards", input: { /* see input_schema */ }, dry_run: true })
omnial_execute({ tool: "usaspending/contract-awards", input: { /* ... */ } })
// 5. settle: the call is charged when it finishes, nothing to doNot connected yet? Point your MCP client at https://mcp.eden-engine.com/mcp, then copy a config for your client.
Pricing
Every charge this tool can incur.
| Charge | Price |
|---|---|
Per call | $0.0026 |
- Updated
- Oct 20, 2026
Input and output schemas
Input schema
input_schema.json
{
"type": "object",
"required": [
"start_date",
"end_date"
],
"properties": {
"page": {
"type": "integer",
"default": 1,
"maximum": 10,
"minimum": 1,
"description": "Which page of `limit` awards to return, starting at 1, up to 10. page_metadata.hasNext says whether another page exists."
},
"sort": {
"enum": [
"Award Amount",
"Total Outlays",
"Start Date",
"End Date",
"Recipient Name",
"Award ID"
],
"type": "string",
"default": "Award Amount",
"description": "The field to sort by."
},
"limit": {
"type": "integer",
"default": 10,
"maximum": 25,
"minimum": 1,
"description": "How many awards to return per page, 1 to 25."
},
"order": {
"enum": [
"desc",
"asc"
],
"type": "string",
"default": "desc",
"description": "desc for largest or latest first (the default), asc for smallest or earliest first."
},
"agencies": {
"type": "array",
"items": {
"type": "object",
"required": [
"type",
"tier",
"name"
],
"properties": {
"name": {
"type": "string",
"maxLength": 200,
"description": "The agency's exact full name as USAspending spells it, for example National Aeronautics and Space Administration or Department of the Air Force. An abbreviation or inexact name matches nothing and returns an empty list."
},
"tier": {
"enum": [
"toptier",
"subtier"
],
"type": "string",
"description": "toptier: a department or independent agency. subtier: a bureau or command inside one."
},
"type": {
"enum": [
"awarding",
"funding"
],
"type": "string",
"description": "awarding: the agency that signed the award. funding: the agency whose money paid for it."
}
},
"additionalProperties": false
},
"maxItems": 3,
"minItems": 1,
"description": "Restrict to awards by these agencies (any one matches). Leave out for every agency. The awarding agency of a result is in its Awarding Agency field, so names can be learned from one search."
},
"end_date": {
"type": "string",
"pattern": "^\\d{4}-(0[1-9]|1[0-2])-(0[1-9]|[12]\\d|3[01])$",
"description": "Last day of the window, YYYY-MM-DD, on or after start_date. Must not be before start_date."
},
"keywords": {
"type": "array",
"items": {
"type": "string",
"maxLength": 100,
"minLength": 3
},
"maxItems": 5,
"minItems": 1,
"description": "Words or phrases matched against the award's description and recipient; an award matching any one is returned (OR, not AND). Each at least 3 characters. Leave out for no keyword filter."
},
"award_ids": {
"type": "array",
"items": {
"type": "string",
"maxLength": 60,
"minLength": 1
},
"maxItems": 10,
"minItems": 1,
"description": "Contract numbers (PIIDs) to look up, for example [\"80NSSC24CA177\"]. Combined with the window and the other filters, so widen the window if a known award does not appear. Leave out for no id filter."
},
"date_type": {
"enum": [
"new_awards_only",
"action_date"
],
"type": "string",
"default": "new_awards_only",
"description": "How the window picks awards. new_awards_only (the default): only awards whose base transaction was signed inside the window. action_date: any award with activity (a modification) inside the window, however old, so most rows were signed earlier and their Award Amount covers their whole life."
},
"start_date": {
"type": "string",
"pattern": "^\\d{4}-(0[1-9]|1[0-2])-(0[1-9]|[12]\\d|3[01])$",
"description": "First day of the window, YYYY-MM-DD. Not earlier than 2007-10-01 (the first day of fiscal year 2008); an earlier date is a validation error. A U.S. fiscal year N runs 1 October of N-1 to 30 September of N, so fiscal year 2026 is 2025-10-01 to 2026-09-30."
},
"recipient_search_text": {
"type": "array",
"items": {
"type": "string",
"maxLength": 100,
"minLength": 2
},
"maxItems": 3,
"minItems": 1,
"description": "Recipient name text, for example [\"lockheed martin\"]; matches part of a recipient's name, and any one of several matches. Leave out for no recipient filter."
}
},
"additionalProperties": false
}Output schema
output_schema.json
{
"type": "object",
"required": [
"results",
"page_metadata"
],
"properties": {
"limit": {
"type": "integer",
"description": "The page size applied."
},
"results": {
"type": "array",
"items": {
"type": "object",
"required": [
"Award ID",
"generated_internal_id"
],
"properties": {
"Award ID": {
"type": "string",
"description": "The contract number (PIID). For a delivery order this is the order's number, and the parent vehicle is inside generated_internal_id."
},
"End Date": {
"type": [
"string",
"null"
],
"description": "Current period-of-performance end, YYYY-MM-DD. Can already be in the past for an old award."
},
"Start Date": {
"type": [
"string",
"null"
],
"description": "Period-of-performance start, YYYY-MM-DD. Can be later than the signing date, even after the search window."
},
"naics_code": {
"type": [
"string",
"null"
],
"description": "The six-digit NAICS industry code of the work."
},
"Description": {
"type": [
"string",
"null"
],
"description": "The agency's free-text description, in capitals as typed. Escape before rendering as HTML."
},
"agency_slug": {
"type": [
"string",
"null"
],
"description": "The awarding agency's USAspending.gov page slug."
},
"internal_id": {
"type": "integer",
"description": "USAspending's internal id for the award."
},
"Award Amount": {
"type": [
"number",
"null"
],
"description": "Dollars obligated to the award over its whole life so far, the sum of every modification. Not the amount spent in the search window and not the contract ceiling."
},
"Recipient UEI": {
"type": [
"string",
"null"
],
"description": "The recipient's twelve-character Unique Entity ID from SAM.gov, the government identifier that replaced the DUNS number."
},
"Total Outlays": {
"type": [
"number",
"null"
],
"description": "Dollars the agency has reported paying out against the award. null means not yet reported, which is common for new awards; it is not zero. It can be negative (a refund or adjustment) and can exceed Award Amount."
},
"Recipient Name": {
"type": [
"string",
"null"
],
"description": "The recipient's name as registered. Dun & Bradstreet Open Data on older awards; attribution is in this tool's source note."
},
"Awarding Agency": {
"type": [
"string",
"null"
],
"description": "The top-tier agency that signed the award, for example Department of Defense."
},
"awarding_agency_id": {
"type": [
"integer",
"null"
],
"description": "USAspending's internal agency id."
},
"Awarding Sub Agency": {
"type": [
"string",
"null"
],
"description": "The bureau or command inside the agency."
},
"Contract Award Type": {
"type": [
"string",
"null"
],
"description": "DEFINITIVE CONTRACT, DELIVERY ORDER, PURCHASE ORDER or BPA CALL."
},
"Awarding Agency Code": {
"type": [
"string",
"null"
],
"description": "That agency's top-tier code, three or four digits, for example 097. It is the code usaspending/agency-budget-by-year takes."
},
"generated_internal_id": {
"type": "string",
"description": "USAspending's unique award key, CONT_AWD_<piid>_<agency>_<parent piid>_<parent agency>. Stable, and the id in the award's USAspending.gov URL."
},
"Awarding Sub Agency Code": {
"type": [
"string",
"null"
],
"description": "The sub-agency's code."
}
},
"additionalProperties": true
},
"description": "One row per contract award. Empty when nothing matches."
},
"messages": {
"type": "array",
"items": {
"type": "string"
},
"description": "Notices from USAspending, normally that searches begin at 2007-10-01."
},
"page_metadata": {
"type": "object",
"required": [
"page",
"hasNext"
],
"properties": {
"page": {
"type": "integer",
"description": "The page returned."
},
"hasNext": {
"type": "boolean",
"description": "True when a later page exists."
},
"last_record_unique_id": {
"type": [
"integer",
"null"
],
"description": "USAspending's paging cursor; ignore it."
},
"last_record_sort_value": {
"type": [
"string",
"null"
],
"description": "USAspending's paging cursor; ignore it."
}
},
"additionalProperties": true
},
"spending_level": {
"type": "string",
"description": "Always awards for this tool."
}
},
"description": "USAspending's response: the matching contract awards in the requested order, and a paging block.",
"additionalProperties": true
}