USA Spending MCP Server

USA Spending MCP Server

Stateless streamable HTTP MCP server for interacting with USASPENDING.gov government spending data.

0
Stars
0
Forks
3
Releases

Overview

USA Spending MCP Server is a stateless, streamable HTTP MCP server designed to provide convenient access to USASPENDING.gov data via the MCP protocol. It enables users to track government spending over time, perform agency-level searches, and explore spending patterns across communities. Built to reference USASPENDING.gov’s API, the server exposes a collection of tools that map to common spending data queries, with documentation and contracts inspired by the official usaspending-api routes. The project emphasizes testing and interoperability with MCP Inspector and a sample MCP Client, and includes commands for running locally, from PyPI, or in Docker. The Tools section enumerates a range of endpoints (federal_accounts, spending, spending_by_award, spending_over_time, subawards, total_budgetary_resources, toptier_agencies, etc.), each documented with a concise purpose. The server is designed to be used by developers, data scientists, and policy researchers who want to integrate or prototype dashboards and analyses on government spending. Claude Desktop integration and environment-based host/port configuration are supported.

Details

Owner
thsmale
Language
Python
License
MIT License
Updated
2025-12-07

Features

Federal accounts

This returns a list of federal accounts, their number, name, managing agency, and budgetary resources.

Budget functions

This retrieves a list of all Budget Functions ordered by their title.

Major object class

This data can be used to better understand the different ways that a specific agency spends money.

Recipient

This can be used to visualize the government spending that pertains to a specific recipient. This returns the recipients, their level, DUNS, UEI, and amount.

Spending drill-down

This data can be used to drill down into specific subsets of data by level of detail. This data represents all government spending in the specified time period, grouped by the data type of your choice.

Spending by award

This allows for complex filtering for specific subsets of spending data. This accepts filters and fields, and returns the fields of the filtered awards.

Spending over time

This returns a list of aggregated award amounts grouped by time period in ascending order.

Total budgetary resources

This is used to provide information on the federal budgetary resources of the government.

Tags

USASPENDING.govgovernment spending dataMCP serverHTTP APIfederal accountsspending_over_timespending_by_awardtop-tier agencies