USA Spending MCP

by thsmale

Not rated
GitHub

About

Track government spending, search government spending be agency, explore government spending to communities, and much more.

Details

Author
thsmale
Categories
Other, Search, Knowledge Base

Setup

Install USA Spending MCP in your MCP client (Claude Desktop, Cursor, Windsurf, and others).

Repository: https://github.com/thsmale/usaspending-mcp-server

Follow the installation instructions in the repository README, then restart your MCP client.

This is a stateless streamable HTTP MCP server for interacting withUSASPENDING.gov, the official source of government spending data. You can track government spending over time, search government spending by agency, explore government spending to communities, and much more. USASPENDING.gov provides this neatdashboardwhich shows some of the powers of the API should you want a high level overview of what you can achieve with this API. The API docs can be viewed at thisURL.

uvx --from usaspending-mcp-server@latest usaspending-mcp-server
docker build -t usaspending-mcp-server . docker run -p 8000:8000 usaspending-mcp-server

Update your claude_desktop_config.json with the following configuration. Ensure the MCP server is running by using one of the methods mentioned above.

{ "mcpServers": { "usaspending": { "command": "npx", "args": [ "mcp-remote", "http://localhost:8000/mcp" ] } } }

The following env or .env variables are accepted to customize what host and port the MCP server runs on.

As each tool is basically a wrapper for an API route, each tool is mapped similarly to the directory structure in the api_contracts directory of the usaspending-api. However, for tools federal_accounts, recipient, spending, and subawards their API mapping are the contracts mentioned in the root directory api_contracts/v2. There is a md file for each tool so it is convenient to reference the documentation used to create the tool. These contracts are rarely updated in the usaspending-api, but checks should still be performed to ensure they are up to date. Currently, all contracts (aka API documentation) are referenced from commitdv551d0of the usaspending-api.

MCP Inspectoris a good way to test the input and output schema without connecting to a LLM. There is also a sampleMCP Clientto test the application using OpenAI. There are also a variety of unit tests focusing on the tool handlers, input/output schemas, and HTTP calls to the USASpending API. They can be run with the following command.

Please see thetestingsection as a starting point to test your changes before submitting a PR. If you are adding a new tool, please also add a copy of the respective contract used as a reference to create theinputSchemaandoutputSchema. Please add the tool to the same path that it exists in the usaspending_apicontactsdirectory. For file naming convention refer to the contract file name and name the tool this as well. For example, if you are creating a tool for thev2/disaster/spending_by_geography.mdAPI route this tool should be added with under the path tools/v2/disaster/spending_by_geography.py and the tool should be named disaster_spending_by_geography. Should there be any objections to this please explain why in the PR as it is not bullet proof!

This project is licensed under the MIT License - see theLICENSEfile for details.

Semantic search through Dickens' classic tale. Find passages by meaning, theme, or concept - not just keywords.

MCP server for the AI Dev Jobs board - 8,400+ open AI/ML engineering roles at 489 companies. Search by role, location, salary, experience level. Live MCP endpoint aidevboard.com/mcp with 4 tools.

API for AI agents to search, license, and download b-roll video clips and voiceovers. Pay-per-request, no human interaction required.

Keyless remote MCP connector to search flights, hotels, and experiences at all-in prices (every mandatory tax and fee included) and book on breckenwander.com.

EU legal research for AI agents: semantic + full-text search over ~48,000 EUR-Lex acts including consolidated versions, daily drift monitoring, answers with verifiable CELEX citations. German, English, French. Remote MCP server at https://conformi.eu/api/mcp — free tier, no key required for article and timeline tools.

Corpus search and linguistic analysis for AI Agents

Security intelligence MCP server — 20 tools: CVE lookup (EPSS/KEV), domain recon, SSL, IP reputation, IOC, exploit search, code security. Free, no API key.

Destiny Codex turns the Destiny 2 Manifest (gibberish hash-reference JSON) into clean, AI-readable text. CLI + MCP server with 9 tools: search, filter, get, relationships, graph traversal, item comparison. Works for 100% of the manifest - all 83 definition tables supported generically.

Server that connects Claude/Cursor to the FatSecret Platform API. Search foods, track your diet, manage recipes, and monitor weight directly from your AI assistant.

Open-source Node.js FHIR MCP server with SMART Backend Services, metadata-aware search/CRUD tools, compact responses, FHIRPath filtering, safe pagination, audit events, and terminology lookup.

No reviews yet — be the first

Sign in to leave a review

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.