USA Spending logo

USA Spending

Live

Federal contract, grant, loan, and direct-payment awards from the Treasury / OMB transparency feed — every prime award since FY2008 with recipient lookup and NAICS slicing.

What is USA Spending?

USAspending.gov surfaces every prime award the federal government has reported under the FFATA / DATA Act since fiscal-year 2008. Slice the data the way an analyst actually wants to: by recipient name (fuzzy match supported), by NAICS code (oil-services use 21 / 2111 / 2131 / 213111 / 213112), by awarding agency toptier code (089 Department of Energy / 097 DoD / 014 Interior), by place of performance, or by free-text keywords. Six award-type groups are filtered separately — contracts, IDVs, grants, loans, direct payments, and other financial assistance — each with its own canonical code list. Pull a single award's full record (parent agency, sub-agency, period of performance, executive compensation, federal action obligations) by generated_internal_id, or pull a recipient's full profile by hash (parent / child / standalone via the -P / -C / -R suffix). Toggle on and use — no setup needed.

Available Tools

  • 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.

Requirements

  • Toggle On
    Toggle on and use — no setup needed.

Quick Setup Guide

Follow these steps to connect your AI agents to this connector

Open /mcp and enable USA Spending with the toggle — no credentials needed.

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

Choose your AI assistant below for specific setup instructions

Follow these steps to connect USA Spending to Claude:

Step 1: Open Claude Settings

Launch Claude → Click the profile button (bottom left) → Navigate to Settings

Step 2: Access Connectors

Scroll down to the Connectors tab → Navigate to the bottom → Click “Add Custom Connector”

Step 3: Name Your Connector

Enter any name you'd like for this connector

Step 4: Get the Connector URL

Log in to PatchOps → Navigate to the /mcp page → Copy the connector URL you want to use

Step 5: Add the Connector

Paste the URL in the “Remote MCP Server URL” text box → Click Add

Step 6: Start Using

Your connector is now ready to use in Claude

Follow these steps to connect USA Spending to ChatGPT:

Step 1: Enable Developer Mode

Go to Settings → Connectors → Advanced → Enable Developer mode

Step 2: Create New Connector

Go back to Connectors page → Click “Create” (top right)

Step 3: Name Your Connector

Enter any name you'd like for this connector (descriptions are optional)

Step 4: Get the Connector URL

Log in to PatchOps → Navigate to the /mcp page → Copy the connector URL you want to use

Step 5: Add the URL

Paste the URL in the “MCP Server URL” text box

Step 6: Set Authentication

Click the authentication dropdown → Select “No authentication” (PatchOps handles authentication internally)

Step 7: Create the Connector

Click “I understand and want to continue” checkbox → Press Create

Step 8: Using the Connector

Start a new chat → Click the + button (left of text box) → Open dropdown → Hover over three dots labeled “More” → Select your connector

Instructions for connecting USA Spending to GitHub Copilot:

Coming Soon

Detailed setup instructions for GitHub Copilot will be added here.

For other MCP-compatible platforms:

Step 1: Get the Connector URL

Log in to PatchOps → Navigate to the /mcp page → Copy the connector URL you want to use

Step 2: Add to Configuration

Add this configuration to your MCP settings file. Replace the URL with your specific connector URL from the /mcp page:

"USA Spending-MCP": {
  "url": "https://patchops.ai/api/mcp/...",
  "type": "http"
}

Example Configuration

Here’s an example using PatchOps MCP:

"PatchOps-MCP": {
  "url": "https://patchops.ai/api/mcp/...",
  "type": "http"
}