We and selected third parties use cookies or similar technologies for technical purposes and, with your consent, to analyze how the site is used.

You can freely give, refuse or withdraw your consent at any time.

USASpending.gov

MCP server by 1102tools

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

No sign-in (No account or key needed)Streamable HTTP

Connect to USASpending.gov

No sign-in needed. Connect with USASpending.gov’s own URL:

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

Paste it into any client that supports remote MCP servers. Your client talks to 1102tools directly, not through mcp.tc.

Share this server

Opens this page, with the URL and setup steps.

mcp.tc/i/usaspending-gov

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 you 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_awardsRead-only

    Search federal contracts, IDVs, grants and loans with many filters.

  • get_award_countRead-only

    Count awards matching filters, grouped by award category.

  • spending_over_timeRead-only

    Aggregate spending by fiscal year, quarter or month.

  • spending_by_categoryRead-only

    Aggregate spending by vendor, agency, NAICS, PSC and other dimensions.

  • get_award_detailRead-only

    Fetch full details for one award by its generated internal ID.

  • get_transactionsRead-only

    Fetch the modification history for an award.

  • get_award_fundingRead-only

    Fetch File C funding data for an award.

  • get_idv_childrenRead-only

    List child task or delivery orders under an IDV.

  • lookup_piidRead-only

    Look up contracts and IDVs by exact PIID.

  • autocomplete_pscRead-only

    Look up Product/Service Codes by code or keyword.

  • autocomplete_naicsRead-only

    Look up NAICS codes by partial code or keyword.

  • list_toptier_agenciesRead-only

    List top-tier federal agencies with codes and budgetary resources.

Show 43 more tools
  • get_agency_overviewRead-only

    Get descriptive information for an agency.

  • get_agency_awardsRead-only

    Get an agency's total obligations and transaction count for a fiscal year.

  • get_naics_detailsRead-only

    Get description, parents and children for a NAICS code.

  • get_psc_filter_treeRead-only

    Browse the PSC hierarchy tree.

  • get_state_profileRead-only

    Get federal award totals for recipients in a US state.

  • search_subawardsRead-only

    Search FFATA subaward reports.

  • spending_by_subaward_groupedRead-only

    Find prime awards with cumulative FFATA subaward totals.

  • search_recipientsRead-only

    Search vendors and grantees by keyword.

  • get_recipient_profileRead-only

    Get a full recipient profile by its USAspending hash.

  • get_recipient_childrenRead-only

    List child recipients of a parent by UEI or DUNS.

  • autocomplete_recipientRead-only

    Find recipient names by partial name or UEI/DUNS.

  • list_statesRead-only

    List states with FIPS codes and award totals.

  • get_agency_budgetary_resourcesRead-only

    Get agency budgetary resources, obligations and outlays by fiscal year.

  • get_agency_sub_agenciesRead-only

    List subtier organizations of an agency with obligations.

  • get_agency_federal_accountsRead-only

    List an agency's federal accounts with obligations and outlays.

  • get_agency_object_classesRead-only

    Show an agency's spending by OMB object class.

  • get_agency_program_activitiesRead-only

    List program activities within an agency.

  • get_agency_obligations_by_award_categoryRead-only

    Split agency obligations by award category.

  • get_award_funding_rollupRead-only

    Get funding totals and agency and account counts for an award.

  • get_award_subaward_countRead-only

    Count subawards reported on an award.

  • get_award_federal_account_countRead-only

    Count federal accounts funding an award.

  • get_award_transaction_countRead-only

    Count transactions on an award.

  • awards_last_updatedRead-only

    Get the timestamp of the last award data refresh.

  • spending_by_transactionRead-only

    Search at the transaction (modification) level.

  • spending_by_geographyRead-only

    Break down spending by state, county or district.

  • new_awards_over_timeRead-only

    Show the trend of new awards to a recipient over time.

  • get_idv_amountsRead-only

    Get top-line amounts for an IDV.

  • get_idv_fundingRead-only

    List File C funding records for an IDV.

  • get_idv_funding_rollupRead-only

    Get IDV Funding Rollup

  • get_idv_activityRead-only

    Get IDV Activity

  • autocomplete_awarding_agencyRead-only

    Autocomplete Awarding Agency

  • autocomplete_funding_agencyRead-only

    Autocomplete Funding Agency

  • autocomplete_cfdaRead-only

    Autocomplete CFDA

  • autocomplete_glossaryRead-only

    Autocomplete Glossary

  • get_award_types_referenceRead-only

    Get Award Types Reference

  • get_def_codes_referenceRead-only

    Get DEF Codes Reference

  • get_glossaryRead-only

    Get Glossary

  • get_submission_periodsRead-only

    Get Submission Periods

  • list_federal_accountsRead-only

    List Federal Accounts

  • get_federal_account_detailRead-only

    Get Federal Account Detail

  • get_federal_account_object_classesRead-only

    Get Federal Account Object Classes

  • get_federal_account_program_activitiesRead-only

    Get Federal Account Program Activities

  • get_federal_account_fy_snapshotRead-only

    Get Federal Account Fiscal Year Snapshot

Read from the live server on 6 Nov 2026. Read-only, Writes and Can delete are hints the server declares; your client decides whether to ask before running a tool.

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?

Set up

Every client connects to usaspending.1102tools.com. Pick yours; the page remembers your choice.

Claude Code

  1. Run this in a terminal, in your project folder:
claude mcp add --transport http usaspending-gov https://usaspending.1102tools.com/mcp
  1. 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:
https://usaspending.1102tools.com/mcp
  1. 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:
  1. Check that the URL reads https://usaspending.1102tools.com/mcp and click Add.
  2. 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

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

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

VS Code

Or from a terminal:

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
{
  "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
{
  "mcpServers": {
    "usaspending-gov": {
      "serverUrl": "https://usaspending.1102tools.com/mcp"
    }
  }
}
  1. Refresh the MCP server list in Cascade.

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

Codex

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

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

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

Gemini CLI

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.

{
  "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.

Embed

Show USASpending.gov in a README or on your site. Each embed links to this page, uses the server’s own URL, and sets no cookies. How embeds work

The card, the iframe and the JSON are in English. Add ?lang=it, fr, de or es to their address for another language.

README badge

Badge preview, lightBadge preview, dark
Markdown
[![USASpending.gov on mcp.tc](https://mcp.tc/i/usaspending-gov/badge.svg)](https://mcp.tc/i/usaspending-gov)
HTML
<a href="https://mcp.tc/i/usaspending-gov"><img src="https://mcp.tc/i/usaspending-gov/badge.svg" alt="USASpending.gov on mcp.tc" height="20"></a>

It follows the reader’s light or dark mode. Add ?theme=light or ?theme=dark to fix it, or ?style=compact to show the mark without the word.

Website card

HTML
<script src="https://mcp.tc/w/usaspending-gov.js" async></script>

The card appears where the tag is. Add data-theme="dark" or data-size="compact" to the tag to change it. The file holds everything it needs, so it makes no other requests and sets no cookies.

iframe

HTML
<iframe src="https://mcp.tc/embed/usaspending-gov" title="USASpending.gov on mcp.tc" width="420" height="200" loading="lazy" allow="clipboard-write" style="border:0;border-radius:8px;max-width:100%"></iframe>

Use it on pages that don’t allow scripts. Add ?theme=light or ?theme=dark to the address to fix the colors.

JSON

The listing as data for your own pages and tools: name, tagline, the server’s own URL, tools and the “Add to” links. Any site can read it (CORS is open).

https://mcp.tc/i/usaspending-gov.json

What each field means

AI prompt

Paste this into an AI coding assistant, such as Claude Code or Cursor, and it adds the USASpending.gov card to your site.

Markdown
Add the mcp.tc card for USASpending.gov, an MCP server, to my website. It is one static script: no build step, no package to install, no cookies.

Put this tag where the card should appear. The card renders right before it:

```html
<script src="https://mcp.tc/w/usaspending-gov.js" async></script>
```

To show the card somewhere else, put this placeholder there and load the same script once, for example before `</body>`. Keep the link inside: visitors without JavaScript see it.

```html
<div data-mcptc="usaspending-gov"><a href="https://mcp.tc/i/usaspending-gov">USASpending.gov on mcp.tc</a></div>
```

Options:
- `data-theme="light"` or `"dark"` on the tag or the placeholder fixes the colors. Without it, the card follows the visitor’s light or dark mode.
- `data-size="compact"` gives a smaller card without the tagline.
- The CSS variable `--mcptc-max-width` on the placeholder or a parent sets the width (default `520px`).
- `?lang=` on the script URL sets the card’s language: `en`, `it`, `fr`, `de` or `es`.

If the site has a Content Security Policy, allow `script-src https://mcp.tc` and `img-src data:` (the icon is inline).

For a README or other Markdown docs, use the badge instead:

```markdown
[![USASpending.gov on mcp.tc](https://mcp.tc/i/usaspending-gov/badge.svg)](https://mcp.tc/i/usaspending-gov)
```

Reference: https://mcp.tc/embed

Change history

We read this server’s tool list every 3 hours and record what changes. Last read 7 Nov 2026, 14:43 UTC.

Follow USASpending.gov and we’ll email you when something changes.

  1. , Automatic check

    New version 1.0.29 (was 1.0.28). Reported by the server.

  2. , Automatic check

    Tracking started: 55 tools.

FAQ

Can I paste mcp.tc/i/usaspending-gov into my MCP client?

No. mcp.tc links are pages, not server addresses. Connect with https://usaspending.1102tools.com/mcp, so your client talks to USASpending.gov directly. The quick link is for sharing: it opens this page, with setup steps for every client.

Does USASpending.gov need an API key or a sign-in?

No. USASpending.gov doesn’t ask for an account or key.

Is USASpending.gov a remote or a local server?

Remote. 1102tools hosts it at https://usaspending.1102tools.com/mcp, and it speaks Streamable HTTP. There’s nothing to install.

What can USASpending.gov do?

It has 55 tools, including search_awards, get_award_count and spending_over_time. You can search contracts, IDVs, grants and loans with agency, NAICS, PSC and set-aside filters, fetch award details, transaction history and File C funding data and aggregate spending over time, by category, and by geography.

Which clients can use it?

Any client that supports remote MCP servers: Claude Code, Claude Desktop, claude.ai, ChatGPT, Cursor, VS Code, Devin Desktop, Codex, Gemini CLI, Zed and others. The setup steps cover each one.

Does mcp.tc track changes to USASpending.gov?

Yes. USASpending.gov’s History tab shows each change we find to its tools, down to descriptions and parameters, plus new versions and edits by its owner. Follow the listing to get an email when it changes.

Who wrote this page?

mcp.tc’s robot read USASpending.gov’s own metadata (its MCP handshake, tool list and public pages), and an AI model drafted the text from it. A person reviews anything the checks can’t confirm. The text can still be wrong, so if you spot a mistake, use Report this listing on this page.

mcp.tc isn’t affiliated with 1102tools. This page was built from USASpending.gov’s public metadata, last checked on 6 Nov 2026, and an AI model wrote the description, so it can be wrong. Names and marks belong to their owners. Something off? Report this listing.