# USASpending.gov

> USASpending.gov is an open-source MCP server for legal and government. Search federal awards, grants, recipients and agency spending from USAspending.gov. It can run locally on your machine or as a hosted remote server.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, API, self-hosted
- **Website:** https://1102tools.com
- **Repository:** https://github.com/1102tools-dev/federal-contracting-mcps/tree/HEAD/servers/usaspending-gov-mcp
- **MCP Registry name:** com.1102tools/usaspending-gov-mcp
- **Categories:** legal and government, analytics and data
- **Listing updated:** 2026-11-14

## About

With 55 tools over the USAspending.gov REST API, this is the largest of the 1102tools federal servers. Search tools cover contracts, IDVs, grants, loans and direct payments, with aggregation by fiscal year, quarter or month, category breakdowns by agency, vendor, NAICS or state, and geography down to congressional district.

Award detail tools return a single award's record, its modification history, File C funding data, task or delivery orders under an IDV and subaward counts. Recipient tools support autocomplete, profiles and parent-to-subsidiary lookups using UEI or DUNS. The README also describes a program_numbers filter that narrows assistance searches to a CFDA number such as 93.778 for Medicaid.

No API key is needed locally or hosted. The README says the October 2026 releases were checked with realistic questions on award histories, fiscal-year totals and subcontract reports.

## Features

- **Award search:** Primary search across contracts, IDVs, grants, loans and direct payments.
- **Spending aggregation:** Time series and top-N breakdowns by agency, vendor, NAICS, PSC or state.
- **Award detail and history:** Full record, modifications and funding data for a single award.
- **Subaward reporting:** Subawards under a prime and grouped cumulative totals.
- **Recipient profiles:** Search recipients and walk from a parent to its subsidiaries.
- **CFDA filtering:** Narrow assistance spending to an assistance listing number.

## Good for

- Review a competitor's federal award history
- Total agency obligations by fiscal year
- Trace the task orders issued under an IDV
- Find subcontractors reported under a prime award
- Size grant funding for a specific assistance program

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http usaspending-gov-mcp https://usaspending.1102tools.com/mcp
```

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://usaspending.1102tools.com/mcp
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "usaspending-gov-mcp": {
      "url": "https://usaspending.1102tools.com/mcp"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "usaspending-gov-mcp": {
      "type": "http",
      "url": "https://usaspending.1102tools.com/mcp"
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "usaspending-gov-mcp": {
      "serverUrl": "https://usaspending.1102tools.com/mcp"
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "usaspending-gov-mcp": {
      "type": "http",
      "url": "https://usaspending.1102tools.com/mcp"
    }
  }
}
```

## Tools

- `search_awards`: Primary search for contracts, IDVs, grants, loans and direct payments
- `get_award_count`: Dimensional counts across award categories
- `spending_over_time`: Time series aggregation by fiscal year, quarter or month
- `spending_by_category`: Top N breakdowns by agency, vendor, NAICS, PSC, state and more
- `spending_by_transaction`: Modification-level transaction search
- `spending_by_geography`: State, county or congressional district breakdown
- `new_awards_over_time`: Pipeline trend for a recipient
- `get_award_detail`: Full record for a single award
- `get_transactions`: Full modification history for an award
- `get_award_funding`: File C funding data for an award
- `get_idv_children`: Task and delivery orders under an IDV
- `search_subawards`: Subawards under a single prime
- `search_recipients`: Search recipients by keyword
- `get_recipient_profile`: Full recipient record
- `get_recipient_children`: Subsidiaries of a parent recipient
- `autocomplete_recipient`: Find recipient names by partial name
- `autocomplete_cfda`: Find assistance listing numbers by program name
- `list_toptier_agencies`: List top-tier agencies
- `get_agency_overview`: Overview of an agency
- `get_agency_budgetary_resources`: Budget resources by fiscal year

## FAQ

### How many tools does it expose?

The README says 55.

### Do I need an API key?

No key is required, locally or hosted.

### How do I find a recipient's subsidiaries?

Take a name from autocomplete_recipient to search_recipients, then pass the parent row's uei to get_recipient_children.

### How do I find a CFDA number?

Use autocomplete_cfda with the program name.

### Is USASpending.gov free?

Yes. USASpending.gov is open source, so you can use and self-host it for free.

### How do I add USASpending.gov to Claude Code?

Run this command in your terminal: claude mcp add --transport http usaspending-gov-mcp https://usaspending.1102tools.com/mcp

### What are the best alternatives to USASpending.gov?

The closest alternatives to USASpending.gov are Agent-Native Analytics, Google Ads + Meta Ads + SEO/GEO MCP, Tapetide - Indian Stock Market MCP, World Monitor and CompanyData.

## Alternatives

- [Agent-Native Analytics](https://ai-powered.com/mcp/agent-native-analytics): Agent-Native Analytics is an open-source MCP server for analytics and data.
- [Google Ads + Meta Ads + SEO/GEO MCP](https://ai-powered.com/mcp/google-ads-meta-ads-seo-geo-mcp): Google Ads + Meta Ads + SEO/GEO MCP is a freemium MCP server for marketing and seo.
- [Tapetide - Indian Stock Market MCP](https://ai-powered.com/mcp/tapetide-indian-stock-market-mcp): Tapetide - Indian Stock Market MCP is a freemium MCP server for finance and payments.
- [World Monitor](https://ai-powered.com/mcp/world-monitor): World Monitor is a freemium MCP server for analytics and data.
- [CompanyData](https://ai-powered.com/mcp/companydata): CompanyData is a paid MCP server for analytics and data.
- [NY LLC Publication (FileMyPublication)](https://ai-powered.com/mcp/ny-llc-publication-filemypublication): NY LLC Publication (FileMyPublication) is a free MCP server for legal and government.
- [ChartAnt](https://ai-powered.com/mcp/chartant): ChartAnt is a freemium MCP server for design and media.
- [Quantivex Research](https://ai-powered.com/mcp/quantivex-research): Quantivex Research is a free MCP server for finance and payments.

---
Source: https://ai-powered.com/mcp/usaspending-gov
