Usaspending MCP Server - install, status & alternatives [2026]

01 · Install Usaspending MCP Server

before you install - you'll need

Set MCP_TRANSPORT_TYPE, MCP_LOG_LEVEL before connecting.

Claude Code

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

Claude Desktop / Cursor / VS Code - add to config

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

Same JSON for Cursor. For VS Code, rename the top-level key from `mcpServers` to `servers`.

Using another client? Same JSON, different key

Claude Desktop · mcpServers

Cursor · mcpServers

VS Code · servers

Windsurf · mcpServers

Zed · context_servers

Cline · mcpServers

Roo Code · mcpServers

Continue · mcpServers

LibreChat · mcpServers

Gemini CLI · mcpServers

Codex CLI · mcp_servers

Full setup guides: every client.

02 · Evidence

https://usaspending.caseyjhand.com/mcp

transport: streamable-http

endpoint alive - responded to MCP initialize · probed 2026-09-30

Security posture

What to check before giving this server access to your agent - from the registry, GitHub, and our own probes. We don't score safety; we show what's verifiable.

runs as local process (stdio) - runs on your machine with your user's permissions · remote - your agent's requests go to usaspending.caseyjhand.com

endpoint auth accepted our unauthenticated MCP initialize - no credentials needed to connect

license Apache-2.0 - declared in the repository

npm package @cyanheads/usaspending-mcp-server - published under the repo owner's npm scope (@cyanheads)

registry namespace io.github.cyanheads is GitHub-verified and matches the repo owner

03 · What Usaspending MCP Server can do

Prose above is summarized from the project's README and registry record - no invented capabilities.

What you can build

With this server connected, an agent can list every top-tier federal agency with its toptier code, slug, and current-year budget totals, search awards by keyword, recipient, agency, award type, NAICS code, assistance listing, location, or date range, fetch one award's full record: amounts, recipient, agencies, codes, parent IDV, DEF-code funding, and list the transactions (modifications, amendments) on an award.

The 18 tools it gives your agent

Extracted from the project's README - what usaspending-mcp-server lets an agent do.

usaspending_list_agencies: - List every top-tier federal agency with its toptier code, slug, and current-year budget totals
usaspending_autocomplete_filters: - Look up NAICS, PSC, CFDA, agency, or recipient codes from a free-text description
usaspending_search_awards: - Search awards by keyword, recipient, agency, award type, NAICS code, assistance listing, location, or date range
usaspending_get_award: - Fetch one award's full record: amounts, recipient, agencies, codes, parent IDV, DEF-code funding
usaspending_get_award_transactions: - List the transactions (modifications, amendments) on an award
usaspending_get_award_subawards: - List the subcontracts or subgrants under a prime award
usaspending_get_award_federal_accounts: - List the Treasury federal accounts that funded an award, with the amount from each
usaspending_get_idv_awards: - List the child orders and sub-IDVs placed under an IDV
usaspending_search_recipients: - Search recipients by name, UEI, or DUNS
usaspending_get_recipient: - Fetch a recipient's profile: address, business types, parent, and award totals
usaspending_get_agency: - Fetch an agency's mission, latest-year budget totals, sub-agencies, and DEF codes
usaspending_spending_by_geography: - Aggregate spending by state, county, or congressional district

show all 18 tools

usaspending_spending_by_category: - Aggregate spending by NAICS, PSC, agency, CFDA program, or recipient
usaspending_spending_over_time: - Aggregate spending by fiscal year, quarter, or month
usaspending_disaster_spending: - Break down disaster and emergency supplemental spending by agency, program, recipient, or geography
usaspending_search_federal_accounts: - Search federal accounts by title keyword or agency identifier
usaspending_get_federal_account: - Fetch a federal account's budget totals and its Treasury Account Symbol components
usaspending_get_federal_account_breakdown: - Break a federal account's obligations down by program activity or object class

Latest releases

v0.4.4 · 2026-09-25

Error contract, date filters, award-type-aware search sort · Timeout and ServiceUnavailable errors carry api_timeout / api_unavailable, retryable, and the calling tool's recovery hint; the disaster tool's timeout hint…

v0.4.3 · 2026-09-20

mcp-ts-core ^0.13.6 adoption · The framework skill tree moves from skills/ to framework-skills/ - Claude Code and Codex auto-load a plugin's root skills/, which handed this server's development skills to every…

v0.4.2 · 2026-08-25

mcp-ts-core SDK v2 adoption · tool arguments are strict - an argument key a tool's schema doesn't declare is now rejected by name instead of silently dropped, and every advertised inputSchema carries…

04 · Who maintains Usaspending MCP Server

usaspending-mcp-server is maintained by cyanheads. We track 137 MCP servers from cyanheads - 131 actively maintained, 1,856 combined GitHub stars, oldest repo from Dec 2024. Full record: all servers from cyanheads.

05 · Facts

repository: github.com/cyanheads/usaspending-mcp-server
category: data & analytics - ranked #25 of 86 actively-maintained data & analytics servers as of 2026-09-30.
release cadence: 10+ releases in the last 90 days (latest 2026-09-25)
registry: io.github.cyanheads/usaspending-mcp-server (active, first published 2026-05-26 · 24 versions)
packages: npm:@cyanheads/usaspending-mcp-server · npm:@cyanheads/usaspending-mcp-server

06 · Usaspending MCP Server FAQ

Is Usaspending MCP Server still maintained?

Yes - as of 2026-09-30, its last commit was 2026-09-25 and it shipped 10+ releases in the last 90 days. We re-verify nightly.

What can Usaspending MCP Server do?

With this server connected, an agent can list every top-tier federal agency with its toptier code, slug, and current-year budget totals, search awards by keyword, recipient, agency, award type, NAICS code, assistance listing, location, or date range, fetch one award's full record: amounts, recipient, agencies, codes, parent IDV, DEF-code funding, and list the transactions (modifications, amendments) on an award.

How do I install Usaspending MCP Server?

Run `npx -y @cyanheads/usaspending-mcp-server`. The README documents 2 environment variables (MCP_TRANSPORT_TYPE, MCP_LOG_LEVEL) to set first. Set MCP_TRANSPORT_TYPE, MCP_LOG_LEVEL before connecting. You can also paste the ready-made client config above.

Does Usaspending MCP Server require authentication?

No - the endpoint accepted our unauthenticated MCP initialize when probed on 2026-09-30; you can connect without credentials.

07 · Alternatives to Usaspending MCP Server

Alternatives to Usaspending MCP Server

Maintained data & analytics servers if Usaspending MCP Server isn't the fit.

Pairs well with

Servers that cover what Usaspending MCP Server doesn't - only shown when the pairing reason fits the companion.

More data & analytics MCP servers · Convalytics · Hop · Meta Data MCP · Dimensions Analytics · Wildberries

More TypeScript MCP servers · Who Gho MCP Server · Wikidata MCP Server · Wikipedia MCP Server · Workflows MCP Server · Worldbank MCP Server · see all