USAspending MCP

A free, key-less Model Context Protocol server for USAspending.gov — the U.S. government's official record of federal spending. Query contracts, grants, loans, recipients, agencies, and geographic breakdowns directly from the primary source. No API key, no account.

Built with FastMCP. Data covers FY2008-present.

Tools

Related MCP server: fpds-mcp

Install

git clone https://github.com/jsconiers/usaspending-mcp.git
cd usaspending-mcp
python3 -m venv .venv
.venv/bin/pip install -r requirements.txt
.venv/bin/python test_usaspending.py   # offline tests

Use with Claude Desktop

Add to claude_desktop_config.json (macOS: ~/Library/Application Support/Claude/claude_desktop_config.json):

{
  "mcpServers": {
    "usaspending": {
      "command": "/absolute/path/to/usaspending-mcp/.venv/bin/python",
      "args": ["/absolute/path/to/usaspending-mcp/usaspending_mcp.py"]
    }
  }
}

Restart Claude Desktop, then ask things like "Who are the top DoD contractors this fiscal year?", "How much has Lockheed Martin been awarded?", or "Show federal contract spending by state."

Award categories

award_category accepts a friendly group that expands to USAspending award-type codes:

Pass award_type_codes explicitly to override.

Examples

list_agencies(search="defense")                  -> Department of Defense (code 097)
search_awards(recipient="Lockheed Martin")       -> largest contracts + award_internal_id
award_count(recipient="Lockheed Martin")         -> {contracts: 6501, grants: 21, idvs: 233, ...}
top_recipients(agency="Department of Defense")   -> Lockheed, Electric Boat, Raytheon, ...
spending_by_category(category="naics", agency="Department of Defense")
spending_by_geography(geo_layer="state", agency="Department of Defense")
recipient_search(name="Lockheed Martin")         -> UEI / DUNS + recipient_id

Typical flow: search_awards (or top_recipients) to find an award/recipient, then award_details / recipient_details for the full record.

Data source

All data comes from the public USAspending.gov REST API (https://api.usaspending.gov/). Please be considerate with request volume.

License

MIT — see LICENSE. Not affiliated with or endorsed by USAspending.gov or the U.S. government. For informational purposes only.