usaspending_spending_by_geography
Aggregate federal spending by state, county, or congressional district. Returns per-capita figures when combined with population data.
How to use it
Project documentation lists usaspending_spending_by_geography for the Usaspending MCP Server MCP server. Add the server to your MCP client (Claude Desktop, Cursor, Windsurf and others), then check which tools your installed version makes available. Tool availability can depend on configuration and credentials. A server handshake does not verify this tool’s behavior. See the full listing for setup details.
Install Usaspending MCP Server
docker run --rm -p 3010:3010 usaspending-mcp-serverOther tools in Usaspending MCP Server (17)
Look up valid code values for filter fields: NAICS, PSC, CFDA, recipient names, or agency names. Use before filtering to discover the right code from a description.
Fetch disaster and emergency supplemental spending (COVID-19, hurricanes, etc.) broken down by agency, CFDA program, recipient, or geography. Filter by DEF codes to isolate a specific appropriation.
Fetch an agency's fiscal year overview: mission, budget authority, obligation totals, sub-agency count, and DEF codes. Accepts a 3-digit toptiercode or an agencyslug from award search results.
Fetch full details of a federal award by its generated ID. Returns contract or assistance data, parent IDV info, subaward count, and funding account linkages.
List the Treasury federal accounts that funded an award, with the amount obligated from each. Returns federalaccount for chaining into usaspendinggetfederalaccount.
List subaward contracts or grants under a prime award. Reveals the sub-contractor or sub-grantee layer — who actually does the work.
List individual transactions (modifications, amendments) on an award. Reveals spending history and obligation changes over time.
Fetch a federal account's budget data: total obligations, outlays, budgetary resources, and the per-Treasury-Account-Symbol component breakdown. Account codes come from usaspendingsearchfederalaccounts.
Break a federal account's obligations down by program activity (what the money funds) or object class (what it buys). Paginated with a total count.
List child contracts and task/delivery orders placed under an IDV award. Each row includes a generateduniqueawardid for chaining into usaspendinggetaward.
Fetch a recipient's profile: address, business types, parent organization, alternate names, and total award amounts by type.
List all top-tier federal agencies with toptier codes, budget authority amounts, and obligation totals. Entry point for agency navigation.
Search federal awards by keyword, recipient, agency, award type, NAICS code, location, or date range. Returns ranked award summaries with recipient names, amounts, agencies, and award IDs for chaining.
List and keyword-search federal accounts by agency identifier or title keyword. Returns account numbers for chaining into usaspendinggetfederalaccount.
Search for organizations receiving federal funds by name, UEI, or DUNS. Returns recipient hash IDs, UEI/DUNS, total award amounts, and hierarchy level. Paginated — page through with page; pagemetadata.total reports the full match count.
Aggregate spending grouped by NAICS code, PSC code, awarding agency, funding agency, CFDA program, or recipient. Returns top items with amounts for trend and breakdown analysis.
Fetch aggregated spending by fiscal year, fiscal quarter, or fiscal month. Filter by award type, agency, recipient, or keyword to trace trends in a specific area.