Available tools
8 tools| Tool | Description |
|---|---|
searchAwards | Federal awards search. Filter timePeriod, awardTypeGroup (contracts / idvs / grants / loans / direct_payments / other_financial_assistance), recipient name, NAICS codes, awarding agency toptier_code, place of performance, free-text keywords. |
getAwardById | Full award record by generated_internal_id, parent and sub-agency, period of performance, federal action obligations, executive compensation. |
searchByRecipient | Convenience wrapper for recipient-name fuzzy search (uses recipient_search_text under the hood). Defaults to contracts and the past 5 fiscal years. |
searchByNaics | Convenience wrapper for NAICS slicing. Oil-services use 21 / 2111 / 2131 / 213111 / 213112. |
searchByAgency | Awards filtered by awarding agency toptier_code (e.g. 089 DOE, 097 DoD, 014 Interior). |
getRecipientById | Full recipient profile by hash. Hash carries -C (child), -P (parent), or -R (standalone) suffix, pass verbatim. |
autocompleteRecipient | Fuzzy recipient-name autocomplete, use to discover the recipient hash before calling getRecipientById. |
getServiceInfo | Award type group taxonomy, agency (toptier_code) reference, NAICS reference, pagination invariants. |
Setup
A few steps to connect your AI agents to USA Spending.
- 1
Toggle Connector On
Open /mcp and enable USA Spending with the toggle, no credentials needed.
- 2
Start Querying
Call searchAwards with timePeriod and awardTypeGroup: 'contracts' to surface federal contract awards, then pivot via generated_internal_id to getAwardById for the full record. searchByNaics with naicsCode: '213112' returns drilling-services awards across the federal government.
Connect to your AI assistant
Pick the tool your team uses for the exact setup steps.
- 1
Open Claude settings
Launch Claude, click the profile button (bottom left), and go to Settings.
- 2
Access connectors
Open the Connectors tab, scroll to the bottom, and click “Add custom connector”.
- 3
Name your connector
Enter any name you’d like for this connector.
- 4
Get the connector URL
Log in to PatchOps, open the /mcp page, and copy the connector URL you want to use.
- 5
Add the connector
Paste the URL into the “Remote MCP server URL” box and click Add.
- 6
Start using
Your USA Spending connector is ready to use in Claude.