MCP server

Usaspending

io.github.cyanheads/usaspending-mcp-server

Checked 26 Oct 2026, 08:29 UTC · Connected to it and listed its tools

Access US federal award, recipient, agency, and spending analytics data from USAspending.gov.

Source

At a glance

Type

MCP server

Publisher

Not verified

Status

Working at last check

Tools

18

Token cost

About 15,005 tokens per request

Sets up in

Claude Code, Claude Desktop, Codex, Gemini CLI, Cursor, VS Code, Antigravity, ChatGPT, OpenAI API, Grok

Last checked

26 Oct 2026, 08:29 UTC

Connect it to your agent

Add to CursorAdd to VS CodeVS Code Insiders

Opens the app, which shows the server and asks you to confirm. For other apps, copy the setup below.

Claude Code

claude mcp add --transport http usaspending-mcp-server https://usaspending.caseyjhand.com/mcp

Claude Desktop

Settings → Connectors → Add custom connector, and paste the URL.

Codex (config.toml)

[mcp_servers.usaspending-mcp-server]
url = "https://usaspending.caseyjhand.com/mcp"

Gemini CLI

{"mcpServers":{"usaspending-mcp-server":{"httpUrl":"https://usaspending.caseyjhand.com/mcp"}}}

Cursor

{"mcpServers":{"usaspending-mcp-server":{"url":"https://usaspending.caseyjhand.com/mcp"}}}

VS Code

{"servers":{"usaspending-mcp-server":{"type":"http","url":"https://usaspending.caseyjhand.com/mcp"}}}

Antigravity

agy mcp add usaspending-mcp-server https://usaspending.caseyjhand.com/mcp

ChatGPT

Settings → Apps & Connectors → Advanced settings: turn on Developer mode, then Create a connector and paste the URL. Which plans can do this varies.

OpenAI API (Responses tools)

{"type":"mcp","server_label":"usaspending-mcp-server","server_url":"https://usaspending.caseyjhand.com/mcp","require_approval":"always"}

Grok (xAI API tools)

{"type":"mcp","server_label":"usaspending-mcp-server","server_url":"https://usaspending.caseyjhand.com/mcp"}

Tools

• usaspending_autocomplete_filters ~651 tokens
  Look up valid code values for filter fields by searching free-text descriptions. Use the type parameter to select the lookup table: naics (NAICS industry codes), psc (product/service codes), cfda (CFDA/Assistance Listing program numbers), awarding_agency (agency and sub-agency names, each with its t
• usaspending_disaster_spending ~789 tokens
  Fetch disaster and emergency supplemental spending (COVID-19, hurricanes, infrastructure law, etc.) broken down by agency, CFDA assistance program, recipient, or geography. Use the dimension parameter to select the breakdown axis: overview (top-level totals), agency, cfda, recipient, or geography. F
• usaspending_get_agency ~468 tokens
  Fetch an agency's fiscal-year overview including mission, budgetary resources, obligation and outlay totals (for the most recent fiscal year with reported budget data), sub-agency count, and DEF codes for disaster/emergency funding. Also returns a paginated sub-agency breakdown with obligation and t
• usaspending_get_award ~368 tokens
  Fetch full details of a federal award by its generated unique award ID. Returns contract or assistance award data including recipient identity (UEI, parent organization, business categories), agency hierarchy, period of performance, place of performance, Assistance Listings with the obligation under
• usaspending_get_award_federal_accounts ~399 tokens
  List the Treasury federal accounts that funded an award, with the amount obligated from each and the funding agency behind it. This is the award → appropriation link: each row returns federal_account (AGENCY-MAIN format, e.g. 080-0120) to chain into usaspending_get_federal_account for the account bu
• usaspending_get_award_subawards ~346 tokens
  List subaward contracts or grants under a prime federal award. Reveals the sub-contractor or sub-grantee layer — the organizations that actually perform the work. Each row shows the subaward number, amount, description, action date, and recipient. Check subaward_count on usaspending_get_award first
• usaspending_get_award_transactions ~354 tokens
  List individual transactions (contract modifications, grant amendments) on a federal award. Each transaction represents a change event — obligation modifications, performance period extensions, scope changes, etc. Use this to trace the spending history and obligation changes over the life of an awar
• usaspending_get_federal_account ~484 tokens
  Fetch a federal account's budget data: total obligations, gross outlays, and budgetary resources, plus the per-Treasury-Account-Symbol (TAS) component breakdown in children. fiscal_year selects a reporting year; omit it for the current federal fiscal year. An empty year retains metadata and a notice
• usaspending_get_federal_account_breakdown ~606 tokens
  Fetch a federal account's obligations broken down by program activity (what the money funds) or object class (what it buys — personnel, supplies, contracts). Use the dimension parameter to select the axis. fiscal_year scopes financial reporting periods to the full October–September year, not award a
• usaspending_get_idv_awards ~478 tokens
  List child contracts and task/delivery orders placed under an IDV (Indefinite Delivery Vehicle) award. Each row includes the generated_unique_award_id to chain into usaspending_get_award for full detail. The award_id must be the generated_unique_award_id of the parent IDV — obtainable from usaspendi
• usaspending_get_recipient ~357 tokens
  Fetch a recipient's full profile including address, business type codes, parent organization, alternate names, and total transaction and loan amounts. Recipient IDs are UUID hashes with a level suffix (-P parent, -C child, -R standalone) from usaspending_search_recipients or usaspending_get_award. T
• usaspending_list_agencies ~370 tokens
  List top-tier federal agencies with toptier codes, agency slugs, budget authority amounts, and obligation totals for the latest reported period. Returns the full directory unless limit is supplied; optional pagination slices the provider-sorted directory. Use this as the entry point for agency navig
• usaspending_search_awards ~3672 tokens
  Search federal awards by keyword, recipient, agency, award type, NAICS code, assistance listing (CFDA) number, PSC, DEF code, location, or date range. Returns ranked award summaries including recipient names, amounts, awarding agencies, and generated award IDs for use with usaspending_get_award; loa
• usaspending_search_federal_accounts ~580 tokens
  List and keyword-search federal accounts by agency identifier or title keyword. Returns account numbers, names, managing agencies, and budgetary resources. fiscal_year selects the resource amounts, not account membership; omit it for the latest available submission year. Search and detail totals use
• usaspending_search_recipients ~409 tokens
  Search for organizations or individuals receiving federal funds by name, UEI (Unique Entity Identifier), or DUNS. Returns recipient hash IDs, UEI/DUNS identifiers, total award amounts, and hierarchy level. Results are paginated — use page to retrieve matches beyond the first page; page_metadata.tota
• usaspending_spending_by_category ~1430 tokens
  Aggregate federal spending grouped by a specific dimension: NAICS industry code, PSC product/service code, awarding agency, funding agency, CFDA assistance program, or recipient. Returns top items with obligation amounts — useful for trend and breakdown analysis. Filter by keyword, award type, agenc
• usaspending_spending_by_geography ~1875 tokens
  Aggregate federal spending by state, county, or congressional district. Useful for per-capita analysis, regional comparisons, and mapping federal investment patterns. Filter by keyword, award type, agency, recipient, NAICS code, Assistance Listing, PSC, DEF code, or date range. Areas are ranked by o
• usaspending_spending_over_time ~1369 tokens
  Fetch aggregated federal obligation amounts grouped by fiscal year, fiscal quarter, or fiscal month. All grouping is relative to the US government fiscal year (Oct–Sep), so fiscal month 1 is October, not January. Filter by award type, agency, recipient, keyword, NAICS code, Assistance Listing, PSC,

Browse

• GitHub tools
• Website monitoring
• Payments
• Legal research
• GitHub and code hosting

Related MCP servers

• MacTech Federal Market
  SAM.gov contract opportunities and entity lookup (BYOK) plus USASpending federal award data.
• LiveDataLink
  294 public-data tools across 60 domains; source freshness varies. Free tier.
• Edgrapi Skills
  US government + SEC data as clean JSON: SAM.gov, USAspending, Grants.gov, Congress, SEC filings.
• Usaspending
  USAspending MCP — Federal spending data from USAspending.gov API
• Federal Contracts & Grants
  US federal contracts, grants, and spending awards
• USASpending.gov
  USAspending.gov contracts, grants, loans, subawards, recipients, agencies, and federal accounts.
• Govcon Contractor Signals
  Federal contractor M&A signals: rising contractors, growth momentum, award search.
• Gouda Studios Agent Tools
  Pay-per-result SAM.gov contracts, SEC EDGAR filings, USAspending awards and GLEIF LEI lookups.

Badge for your README

[![AptLynx](https://aptlynx.net/badge/io.github.cyanheads/usaspending-mcp-server.svg)](https://aptlynx.net/servers/io.github.cyanheads/usaspending-mcp-server)

Listing text is written by the maker; AptLynx lists tools and does not vouch for them. Find another tool · Browse by topic · For agents