io.github.cyanheads/usaspending-mcp-server

up checked 2026-11-11T06:39:55.003Z

Unclaimed · Unverified

Agent searches it appeared in, last 30 days: 0. Run this server? Claim the listing: verified label, uptime alerts and analytics.

Publisher-provided description

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

Summary by lookupd

Query US federal awards, recipients, agencies, accounts, and spending aggregations by category, geography, and time from USAspending.gov.

Install

Claude Code, remote (streamable-http)

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

Claude Code, npm package (stdio)

claude mcp add usaspending-mcp-server -- npx -y @cyanheads/usaspending-mcp-server

Claude Code, npm package (stdio)

claude mcp add usaspending-mcp-server -- npx -y @cyanheads/usaspending-mcp-server

Codex, remote (streamable-http)

codex mcp add usaspending-mcp-server --url https://usaspending.caseyjhand.com/mcp

Codex, npm package (stdio)

codex mcp add usaspending-mcp-server -- npx -y @cyanheads/usaspending-mcp-server

Codex, npm package (stdio)

codex mcp add usaspending-mcp-server -- npx -y @cyanheads/usaspending-mcp-server

Cursor, remote (streamable-http) → .cursor/mcp.json

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

Cursor, npm package (stdio) → .cursor/mcp.json

{
  "mcpServers": {
    "usaspending-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "@cyanheads/usaspending-mcp-server"
      ]
    }
  }
}

Cursor, npm package (stdio) → .cursor/mcp.json

{
  "mcpServers": {
    "usaspending-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "@cyanheads/usaspending-mcp-server"
      ]
    }
  }
}

Other clients: docs. Or tell your agent: Set up lookupd for me: read https://lookupd.com/agent.md and follow it.

Tools (18 tools)

Publisher-provided text

• 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 ful
• 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)
• 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. Returns r
• 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 orga
• usaspending_get_award_transactions List individual transactions (contract modifications, grant amendments) on a federal award. Each transaction represents a change event — obligation modification
• 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 wor
• 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
• 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
• 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 identifie
• usaspending_get_recipient Fetch a recipient's full profile including address, business type codes, parent organization, alternate names, and total transaction and loan amounts. Recipient
• 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 budge
• usaspending_spending_by_geography Aggregate federal spending by state, county, or congressional district. Useful for per-capita analysis, regional comparisons, and mapping federal investment pat
• usaspending_spending_by_category Aggregate federal spending grouped by a specific dimension: NAICS industry code, PSC product/service code, awarding agency, funding agency, CFDA assistance prog
• 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 (
• 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 DE
• 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
• 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). Us
• 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.

Details

• Version: 0.7.1
• Transports: streamable-http, stdio
• Uptime (7 days): 100%
• Median latency: 840 ms
• First indexed: 2026-11-01T09:26:44.071Z
• Last seen in registry: 2026-11-03T22:17:21.391Z
• Repository: https://github.com/cyanheads/usaspending-mcp-server

Badge for your README

Shows this live status and links here; updates hourly.

[![lookupd status](https://lookupd.com/badge/io.github.cyanheads/usaspending-mcp-server.svg)](https://lookupd.com/servers/io.github.cyanheads/usaspending-mcp-server)

• 62092 servers
• Last crawl: 2026-11-11T17:38:11.606Z
• API base: https://api.lookupd.com
• MCP URL: https://api.lookupd.com/mcp