NestDaddy

Usaspending Mcp Server

io.github.cyanheads/usaspending-mcp-server · v0.7.2

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

Connect Remote server

Terminal
claude mcp add --transport http usaspending-mcp-server https://usaspending.caseyjhand.com/mcp
~/.cursor/mcp.json
{
  "mcpServers": {
    "usaspending-mcp-server": {
      "url": "https://usaspending.caseyjhand.com/mcp"
    }
  }
}
.vscode/mcp.json
{
  "servers": {
    "usaspending-mcp-server": {
      "type": "http",
      "url": "https://usaspending.caseyjhand.com/mcp"
    }
  }
}
Claude Desktop
Settings > Connectors > Add custom connector
URL: https://usaspending.caseyjhand.com/mcp

Tools 18 found in our last check

  • usaspending_list_agencies

    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 p…

  • usaspending_autocomplete_filters

    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 n…

  • usaspending_search_awards

    Search federal awards by keyword, recipient, agency, award type, NAICS code, assistance listing (CFDA) number, PSC, DEF code, location, or date range. Location filters by place of performance (location_filter, or filters.place_of_performance_location, which overrides it) or by w…

  • usaspending_get_award

    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 with its county code, Ass…

  • usaspending_get_award_transactions

    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 ove…

  • usaspending_get_award_subawards

    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 usaspen…

  • usaspending_get_award_federal_accounts

    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_accou…

  • usaspending_get_idv_awards

    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 — obta…

  • usaspending_search_recipients

    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 pag…

  • usaspending_get_recipient

    Fetch a recipient's full profile including address, business type codes, parent organizations, alternate names, and total transaction and loan amounts. Recipient IDs are hexadecimal 8-4-4-4-12 hashes with a level suffix (-P parent, -C child, -R standalone) from usaspending_searc…

  • usaspending_get_agency

    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. budget_by_fiscal_year carries the same totals…

  • usaspending_spending_by_geography

    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, place of perfor…

  • usaspending_spending_by_category

    Aggregate federal spending grouped by a specific dimension: NAICS industry code, PSC product/service code, awarding or funding agency or subagency, CFDA assistance program, recipient, federal account, or Disaster Emergency Fund Code (DEF). Returns top items with obligation amoun…

  • usaspending_spending_over_time

    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, Assi…

  • usaspending_disaster_spending

    Fetch disaster and emergency supplemental spending broken down by agency, CFDA assistance program, recipient, or geography, or request an overview. Filter by DEF codes to select emergency appropriations, then check amount_coverage before interpreting amounts: award breakdowns an…

  • usaspending_get_federal_account

    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…

  • usaspending_get_federal_account_breakdown

    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–Septem…

  • usaspending_search_federal_accounts

    List and keyword-search federal accounts by directory toptier code 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. Se…

Details

Endpointhttps://usaspending.caseyjhand.com/mcp (Streamable HTTP)
Package@cyanheads/[email protected] (NPM, stdio)
Package@cyanheads/[email protected] (NPM, streamable-http)
First published12 Nov 2026
Last updated12 Nov 2026
Registry nameio.github.cyanheads/usaspending-mcp-server

More data and analytics servers See all

Listing data from the official MCP registry. Status and tools from NestDaddy's daily check. Browse all MCP servers.