MCP server for US federal spending data via api.usaspending.gov
Wellknown found it in public sources; nobody has proven control of it yet. Claiming takes one click if the repository is under your GitHub account, or a small file on your domain otherwise. Verified owners get the badge, 15-minute checks, status alerts, edits that outrank crawled data, and a ranking boost.
Agents can do it too: POST https://wellknown.network/api/v1/claims with {"agent":"usaspending-mcp","method":"well_known_file"} — machine-readable steps at claim.json, guide at /docs/claim.
Everything here was measured by our prober or read from a registry. Nothing is self-reported.
Attributed to the source that supplied each field. Treated as claims, not facts.
# usaspending-mcp [](https://github.com/asachs01/usaspending-mcp/actions/workflows/ci.yml) [](https://python.org) [](LICENSE) [](https://modelcontextprotocol.io) Production-grade MCP server for US federal spending data via [api.usaspending.gov](https://api.usaspending.gov). ## Features - **8 decision-tree tools** covering the full USASpending API (awards, agencies, recipients, spending, disaster funding, accounts, downloads) - **Dual transport:** STDIO (Claude Desktop/Code) and Streamable HTTP + SSE (hosted deployments) - **Progress notifications** for long-running paginated searches and bulk downloads - **4 MCP resources:** agencies list, current fiscal year, data freshness, glossary - **Lazy-loaded reference data** with TTL cache (no blocking startup calls) - **No authentication required** — USASpending API is public ## Installation ```bash # From PyPI (when published) pip install usaspending-mcp # From GitHub pip install git+https://github.com/asachs01/usaspending-mcp.git # For development git clone https://github.com/asachs01/usaspending-mcp.git cd usaspending-mcp pip install -e ".[dev]" ``` ## Quick Start ```bash # STDIO mode (default — for Claude Desktop / Claude Code) usaspending-mcp # HTTP mode (for hosted/remote deployments) usaspending-mcp-http # With custom port usaspending-mcp-http --port 9000 # Auto-detect transport python -m usaspending_mcp.server --transport http ``` ## Configuration ### Claude Desktop ```json { "mcpServers": { "usaspending": { "command": "uvx", "args": ["usaspending-mcp"] } } } ``` ### Claude Code ```json { "mcpServers": { "usaspending": { "command": "uvx", "args": ["usaspending-mcp"] } }…
Mapped onto the structured taxonomy from declared text and observed tool names. Confidence shown for derived entries.
Every source is kept verbatim. Field changes are logged as events.