Tools Reference
USAspending
6 tools for accessing USAspending data. No additional API key required.
usa-search-awards
Search federal spending awards — contracts, grants, loans, and direct payments.
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
| keyword | string | optional | Search keyword |
| awardType | string | optional | 'contracts', 'grants', 'loans', 'direct_payments' |
| agency | string | optional | Agency name |
| recipient | string | optional | Recipient name |
| state | string | optional | Two-letter state code |
| startDate | string | optional | Start date YYYY-MM-DD |
| endDate | string | optional | End date YYYY-MM-DD |
| limit | number | optional | Number of results (max 50) |
Example
usa-search-awards(keyword: "cybersecurity", awardType: "contracts")usa-spending-by-agency
Get federal spending breakdown by awarding agency.
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
| fiscalYear | number | optional | Fiscal year, defaults to current |
| limit | number | optional | Number of agencies (max 50) |
Example
usa-spending-by-agency(fiscalYear: 2025)usa-spending-by-state
Get federal spending by state with per capita spending and population data.
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
| state | string | optional | Two-letter state code for single-state detail |
| fiscalYear | number | optional | Fiscal year, defaults to current |
Example
usa-spending-by-state(state: "CA", fiscalYear: 2025)usa-top-recipients
Get the top recipients of federal spending — companies, organizations, and entities.
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
| fiscalYear | number | optional | Fiscal year, defaults to current |
| awardType | string | optional | 'contracts', 'grants', 'loans' |
| limit | number | optional | Number of recipients (max 50) |
Example
usa-top-recipients(awardType: "contracts", fiscalYear: 2025)usa-spending-over-time
Get aggregate federal spending over time by month, quarter, or fiscal year.
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
| group | string | required | 'month', 'quarter', or 'fiscal_year' |
| startDate | string | required | Start date YYYY-MM-DD |
| endDate | string | required | End date YYYY-MM-DD |
| keyword | string | optional | Filter by keyword |
| agency | string | optional | Filter by agency name |
Example
usa-spending-over-time(group: "quarter", startDate: "2023-01-01", endDate: "2025-01-01")usa-agency-overview
Get overview of a federal agency including mission, budget, and obligations.
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
| agencyCode | string | required | Agency code: '097' DoD, '075' HHS, '069' Treasury |
| fiscalYear | number | optional | Fiscal year, defaults to current |
Example
usa-agency-overview(agencyCode: "097", fiscalYear: 2025)