How do I connect Usaspending MCP Server to Claude?

The listing records `docker run --rm -p 3010:3010 usaspending-mcp-server` as its setup step. Run it, then follow the repository's instructions for the client configuration; the listing names Claude Desktop, Cursor, VS Code as compatible clients.

Is Usaspending MCP Server free?

The listed licence is Apache-2.0. Check the upstream terms for permitted use and commercial requirements; a public repository does not by itself mean the software is free or open source. Connected APIs and hosted services may have separate charges.

What can Usaspending MCP Server do?

Usaspending MCP Server documents 18 tools to the agent, including usaspending_autocomplete_filters, usaspending_disaster_spending, usaspending_get_agency. The descriptions above come from project documentation. A live handshake does not test individual tool behavior.

Usaspending MCP Server

Unclaimed

by cyanheads

Access US federal award, recipient, agency, and spending analytics data from USAspending.gov via MCP. STDIO or Streamable HTTP.

Install

$docker run --rm -p 3010:3010 usaspending-mcp-server

Set up this server

Compare servers My Stack

This server needs project-specific setup. Follow the project instructions; no reusable public launch command is available yet.

Project instructions

ai-agentsai-toolscyanheadsdata-actfederal-awardsfederal-spendingfiscal-policygovernment-contractsgovernment-grantsgovernment-procurementmcpmcp-servermodel-context-protocoltreasurytypescriptusaspending

Is this your MCP server?

This listing was auto-indexed from the public record. Claim it to edit the page, set compatibility and unlock growth tools. Takes under two minutes.

Claim this server

Security profile

Claimed and verified servers get a weekly static scan that shows what the code can reach: external services, environment variables, shell commands, agent configuration folders, plus any dependencies with known advisories. Claim this listing to get one. How the security profile works

18 of 18 tools

Documented tools (18)

From project documentation. A server handshake does not verify each tool’s description or behavior.

usaspending_autocomplete_filters

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.

usaspending_disaster_spending

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.

usaspending_get_agency

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.

usaspending_get_award

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.

usaspending_get_award_federal_accounts

List the Treasury federal accounts that funded an award, with the amount obligated from each. Returns federalaccount for chaining into usaspendinggetfederalaccount.

usaspending_get_award_subawards

List subaward contracts or grants under a prime award. Reveals the sub-contractor or sub-grantee layer — who actually does the work.

usaspending_get_award_transactions

List individual transactions (modifications, amendments) on an award. Reveals spending history and obligation changes over time.

usaspending_get_federal_account

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.

usaspending_get_federal_account_breakdown

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.

usaspending_get_idv_awards

List child contracts and task/delivery orders placed under an IDV award. Each row includes a generateduniqueawardid for chaining into usaspendinggetaward.

usaspending_get_recipient

Fetch a recipient's profile: address, business types, parent organization, alternate names, and total award amounts by type.

usaspending_list_agencies

List all top-tier federal agencies with toptier codes, budget authority amounts, and obligation totals. Entry point for agency navigation.

usaspending_search_awards

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.

usaspending_search_federal_accounts

List and keyword-search federal accounts by agency identifier or title keyword. Returns account numbers for chaining into usaspendinggetfederalaccount.

usaspending_search_recipients

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.

usaspending_spending_by_category

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.

usaspending_spending_by_geography

Aggregate federal spending by state, county, or congressional district. Returns per-capita figures when combined with population data.

usaspending_spending_over_time

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.

Tool change history

Compared across complete checks of the same configuration. Tools were listed, not invoked. Input-schema changes are not measured here.

No complete tool checks yet.

FAQ

Questions about Usaspending MCP Server

How do I connect Usaspending MCP Server to Claude?: The listing records `docker run --rm -p 3010:3010 usaspending-mcp-server` as its setup step. Run it, then follow the repository's instructions for the client configuration; the listing names Claude Desktop, Cursor, VS Code as compatible clients.
Is Usaspending MCP Server free?: The listed licence is Apache-2.0. Check the upstream terms for permitted use and commercial requirements; a public repository does not by itself mean the software is free or open source. Connected APIs and hosted services may have separate charges.
What can Usaspending MCP Server do?: Usaspending MCP Server documents 18 tools to the agent, including usaspending_autocomplete_filters, usaspending_disaster_spending, usaspending_get_agency. The descriptions above come from project documentation. A live handshake does not test individual tool behavior.