# USASpending.gov MCP server

> Search federal contracts, grants, loans, subawards, recipients, agencies and federal accounts from USAspending.gov data.

- Listing: https://mcp.tc/i/usaspending-gov
- Connect: use the server's own URL `https://usaspending.1102tools.com/mcp` (no sign-in); clients connect to it directly. The listing link is a page, not an MCP endpoint.
- Type: remote (Streamable HTTP)
- Auth: none
- Category: [Data & Analytics](https://mcp.tc/c/analytics)
- Vendor: 1102tools
- Homepage: <https://1102tools.com>
- Repository: <https://github.com/1102tools-dev/federal-contracting-mcps/tree/HEAD/servers/usaspending-gov-mcp>
- Package: pypi `usaspending-gov-mcp`

## About

Wraps the public USAspending.gov API as 55 read-only tools. You can search awards, count them by category, pull transaction histories and funding records, look up PIIDs, inspect IDVs and their task orders, and break down spending by time, category, geography or transaction.

## What it can do

- Search contracts, IDVs, grants and loans with agency, NAICS, PSC and set-aside filters
- Fetch award details, transaction history and File C funding data
- Aggregate spending over time, by category, and by geography
- Look up recipients, their profiles and child entities
- Review agency budgetary resources, sub-agencies, federal accounts and object classes
- Search FFATA subawards and check award data freshness

## Tools (55)

- `search_awards`: Search federal contracts, IDVs, grants and loans with many filters. (read-only)
- `get_award_count`: Count awards matching filters, grouped by award category. (read-only)
- `spending_over_time`: Aggregate spending by fiscal year, quarter or month. (read-only)
- `spending_by_category`: Aggregate spending by vendor, agency, NAICS, PSC and other dimensions. (read-only)
- `get_award_detail`: Fetch full details for one award by its generated internal ID. (read-only)
- `get_transactions`: Fetch the modification history for an award. (read-only)
- `get_award_funding`: Fetch File C funding data for an award. (read-only)
- `get_idv_children`: List child task or delivery orders under an IDV. (read-only)
- `lookup_piid`: Look up contracts and IDVs by exact PIID. (read-only)
- `autocomplete_psc`: Look up Product/Service Codes by code or keyword. (read-only)
- `autocomplete_naics`: Look up NAICS codes by partial code or keyword. (read-only)
- `list_toptier_agencies`: List top-tier federal agencies with codes and budgetary resources. (read-only)
- `get_agency_overview`: Get descriptive information for an agency. (read-only)
- `get_agency_awards`: Get an agency's total obligations and transaction count for a fiscal year. (read-only)
- `get_naics_details`: Get description, parents and children for a NAICS code. (read-only)
- `get_psc_filter_tree`: Browse the PSC hierarchy tree. (read-only)
- `get_state_profile`: Get federal award totals for recipients in a US state. (read-only)
- `search_subawards`: Search FFATA subaward reports. (read-only)
- `spending_by_subaward_grouped`: Find prime awards with cumulative FFATA subaward totals. (read-only)
- `search_recipients`: Search vendors and grantees by keyword. (read-only)
- `get_recipient_profile`: Get a full recipient profile by its USAspending hash. (read-only)
- `get_recipient_children`: List child recipients of a parent by UEI or DUNS. (read-only)
- `autocomplete_recipient`: Find recipient names by partial name or UEI/DUNS. (read-only)
- `list_states`: List states with FIPS codes and award totals. (read-only)
- `get_agency_budgetary_resources`: Get agency budgetary resources, obligations and outlays by fiscal year. (read-only)
- `get_agency_sub_agencies`: List subtier organizations of an agency with obligations. (read-only)
- `get_agency_federal_accounts`: List an agency's federal accounts with obligations and outlays. (read-only)
- `get_agency_object_classes`: Show an agency's spending by OMB object class. (read-only)
- `get_agency_program_activities`: List program activities within an agency. (read-only)
- `get_agency_obligations_by_award_category`: Split agency obligations by award category. (read-only)
- `get_award_funding_rollup`: Get funding totals and agency and account counts for an award. (read-only)
- `get_award_subaward_count`: Count subawards reported on an award. (read-only)
- `get_award_federal_account_count`: Count federal accounts funding an award. (read-only)
- `get_award_transaction_count`: Count transactions on an award. (read-only)
- `awards_last_updated`: Get the timestamp of the last award data refresh. (read-only)
- `spending_by_transaction`: Search at the transaction (modification) level. (read-only)
- `spending_by_geography`: Break down spending by state, county or district. (read-only)
- `new_awards_over_time`: Show the trend of new awards to a recipient over time. (read-only)
- `get_idv_amounts`: Get top-line amounts for an IDV. (read-only)
- `get_idv_funding`: List File C funding records for an IDV. (read-only)
- `get_idv_funding_rollup`: Funding rollup totals for an IDV (single dict, not paginated). (read-only)
- `get_idv_activity`: List child task/delivery orders awarded under an IDV. (read-only)
- `autocomplete_awarding_agency`: Find awarding agency names by partial match. (read-only)
- `autocomplete_funding_agency`: Find funding agency names by partial match (companion to awarding agency). (read-only)
- `autocomplete_cfda`: Find CFDA (Catalog of Federal Domestic Assistance) program numbers by partial title or program number. (read-only)
- `autocomplete_glossary`: Find glossary terms (acquisition + spending vocabulary) by partial match. (read-only)
- `get_award_types_reference`: Return the full mapping of award type codes to descriptions. (read-only)
- `get_def_codes_reference`: Return all Disaster Emergency Fund (DEFC) codes with public laws. (read-only)
- `get_glossary`: Get the full USASpending glossary of acquisition + spending terms. (read-only)
- `get_submission_periods`: List the reporting calendar and submission/certification deadlines. (read-only)
- `list_federal_accounts`: List Treasury federal accounts (TAS) with budgetary resources. (read-only)
- `get_federal_account_detail`: Get an individual federal account's metadata + budgetary resources. (read-only)
- `get_federal_account_object_classes`: Get the object class breakdown of obligations for a federal account. (read-only)
- `get_federal_account_program_activities`: List program activity codes and names associated with a federal account. (read-only)
- `get_federal_account_fy_snapshot`: Get a single-fiscal-year snapshot of a federal account's resources. (read-only)

## Example prompts

- "Find the top 10 recipients of DoD IT contracts in fiscal year 2025"
- "Show the modification history for contract PIID W91QUZ-20-D-0001"
- "Break down NASA obligations by award category for 2025"
- "Which states received the most federal grant spending last year?"

## Install

### Claude Code

1. Run this in a terminal, in your project folder:

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

2. Start Claude Code and type `/mcp`. **usaspending-gov** should show as connected.

Add `--scope user` to make it available in every project, not just this one.

### Claude Desktop

1. Open **Customize → Connectors**, click **+ Add**, then **Add custom connector**.

2. Name it **USASpending.gov** and paste this URL:

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

3. Click **Add**. Its tools appear in the chat’s tools menu.

Claude Desktop’s JSON config file only starts local servers. Remote servers go through Connectors, and connectors you add on claude.ai show up here too.

### claude.ai

1. Open the connector form on claude.ai. This button fills in the name and URL for you:

[Add to claude.ai](<https://claude.ai/customize/connectors?modal=add-custom-connector&connectorName=USASpending.gov&connectorUrl=https%3A%2F%2Fusaspending.1102tools.com%2Fmcp>) (opens connector settings)

2. Check that the URL reads `https://usaspending.1102tools.com/mcp` and click **Add**.

3. Turn it on in a chat from the tools menu.

Free plans allow one custom connector. On Team and Enterprise plans an owner adds it under **Organization settings → Connectors**.

### ChatGPT

1. On chatgpt.com, go to **Plugins**, select **+**, then **Add custom MCP server**.

2. Enter a name for the server.

3. Under **Connection**, paste `https://usaspending.1102tools.com/mcp` as the server URL, then for authentication choose **No authentication**.

4. Check **I understand and want to continue**, then select **Create as a plugin**.

Whether you can add a custom MCP server depends on your ChatGPT plan and your workspace permissions (in Business workspaces, admins and owners can).

### Cursor

[Add to Cursor](<https://cursor.com/install-mcp?name=usaspending-gov&config=eyJ1cmwiOiJodHRwczovL3VzYXNwZW5kaW5nLjExMDJ0b29scy5jb20vbWNwIn0%3D>) (opens Cursor)

Or add it by hand to `~/.cursor/mcp.json` (all projects) or `.cursor/mcp.json` (this project):

`mcp.json`:

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

### VS Code

[Install in VS Code](<https://vscode.dev/redirect/mcp/install?name=usaspending-gov&config=%7B%22type%22%3A%22http%22%2C%22url%22%3A%22https%3A%2F%2Fusaspending.1102tools.com%2Fmcp%22%7D>) (opens VS Code)

Or from a terminal:

```bash
code --add-mcp '{"name":"usaspending-gov","type":"http","url":"https://usaspending.1102tools.com/mcp"}'
```

Or commit it to the repo in `.vscode/mcp.json`:

`.vscode/mcp.json`:

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

### Devin Desktop

1. Add it to `~/.config/devin/mcp_config.json` (macOS and Linux) or `%APPDATA%\devin\mcp_config.json` (Windows):

`mcp_config.json`:

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

2. Refresh the MCP server list in Cascade.

Devin Desktop is the new name for Windsurf. It reads `serverUrl` (or `url`) for remote servers.

### Codex

```bash
codex mcp add usaspending-gov --url https://usaspending.1102tools.com/mcp
```

Or edit `~/.codex/config.toml` directly:

`config.toml`:

```toml
[mcp_servers.usaspending-gov]
url = "https://usaspending.1102tools.com/mcp"
```

### Gemini CLI

```bash
gemini mcp add --transport http usaspending-gov https://usaspending.1102tools.com/mcp
```

This adds it to the current project. Add `-s user` to use it everywhere.

### Any client

Most clients accept this shape. Some name the URL field differently: `serverUrl` in Devin Desktop, `httpUrl` in Gemini CLI’s settings file.

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

Zed puts servers under `context_servers` in its settings. Cline needs `"type": "streamableHttp"`, or it assumes SSE.

Client only starts local servers? Bridge it with `npx -y mcp-remote https://usaspending.1102tools.com/mcp`.

## Recent changes

- 2026-11-03 08:52 UTC: New version 1.0.29 (was 1.0.28), reported by the server. Source: automatic check.
- 2026-11-01 05:22 UTC: Tracking started: 55 tools read. Source: automatic check.

More on the History tab, with descriptions before and after for the newest entries: https://mcp.tc/i/usaspending-gov#history (Atom feed: https://mcp.tc/i/usaspending-gov/history.xml). It records what mcp.tc's anonymous checks saw, every 3 hours where the tool list can be read without sign-in; it is not a security review.

## Details

- Server version: 1.0.29
- MCP protocol version: 2026-07-28
- Last checked: 2026-11-06 (reachable)
- Listed: 2026-11-01
- Updated: 2026-11-01

---
Source: https://mcp.tc/i/usaspending-gov (mcp.tc is an independent directory, not affiliated with this server's publisher). Corrections: https://mcp.tc/report