USAspending MCP Server
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| USASPENDING_TIMEOUT_MS | No | Request timeout in milliseconds for API calls. Default is 30000. | 30000 |
Capabilities
Features and capabilities supported by this server
| Capability | Details |
|---|---|
| tools | {
"listChanged": true
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| usaspending_list_toptier_agenciesA | List federal toptier agencies with current USAspending budgetary, obligation, and outlay summary fields. No authentication required. |
| usaspending_autocomplete_recipientA | Search recipient names, UEIs, and DUNS values for use in USAspending filters. |
| usaspending_autocomplete_agencyC | Search awarding or funding agency offices for USAspending AdvancedFilterObject agency filters. |
| usaspending_search_awardsA | Search prime awards or subawards with USAspending AdvancedFilterObject filters and selected fields. Use for questions like top awards for a recipient, agency, date range, award type, NAICS, PSC, or keyword. |
| usaspending_spending_by_categoryB | Aggregate obligations/outlays by category such as awarding_agency, recipient_duns, naics, psc, federal_account, state_territory, cfda, or defc. |
| usaspending_spending_by_geographyA | Aggregate spending by state, county, congressional district, or country using place of performance or recipient location. |
| usaspending_spending_over_timeC | Aggregate obligations and outlays over fiscal years, calendar years, quarters, or months for a USAspending filter set. |
| usaspending_new_awards_over_timeA | Count new awards for a specific USAspending recipient over fiscal years, quarters, or months. Requires a recipient_id hash such as values returned by /api/v2/recipient/duns/. |
| usaspending_search_transactionsA | Search individual transaction records with USAspending AdvancedFilterObject filters. Use when award-level results are too aggregated and you need action dates, modifications, or transaction amounts. |
| usaspending_count_transactionsA | Count matching transaction records grouped by award category: contracts, grants, direct payments, loans, IDVs, and other. |
| usaspending_get_awardB | Get detailed USAspending award profile data by generated unique award ID or internal award database ID. |
| usaspending_call_endpointA | Call a documented read-only USAspending v2 endpoint that is not covered by a purpose-built tool. Blocks download and bulk_download paths. Use only with official /api/v2/ endpoints. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
Latest Blog Posts
MCP directory API
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/haydentbs/usaspending-mcp-server'
If you have feedback or need assistance with the MCP directory API, please join our Discord server