ZBS Index What actually exists in applied AI, with the source next to it

mcp server

usaspending-mcp-server

Access US federal award, recipient, agency, and spending analytics data from USAspending.gov.

Description as published by the maintainer. Source

  • version 0.4.1
  • active
  • analytics

active — Most recent push to the repository was 2026-07-27. Dashed tags are derived by ZBS Index from the published description, not stated by the maintainer.

What this server can do

18 functions, named and described by the server itself. Parameter names are shown because they say more about what a function does than its name usually does.

usaspending_autocomplete_filters(type, limit, search_text)
Look up valid code values for filter fields by searching free-text descriptions. Use the type parameter to select the lookup table: naics (NAICS industry codes), psc (product/service codes), cfda (CFDA/Assistance Listing program numbers), awarding_agency (agency names and IDs), or recipient (recipient names with UEI/DUNS). Call this before filtering awards when you know a description but not the exact code. Returns matching codes and names for use in other tool filters. Required: type, search_text.
usaspending_disaster_spending(page, limit, filters, dimension, spending_type)
Fetch disaster and emergency supplemental spending (COVID-19, hurricanes, infrastructure law, etc.) broken down by agency, CFDA assistance program, recipient, or geography. Use the dimension parameter to select the breakdown axis: overview (top-level totals), agency, cfda, recipient, or geography. Filter by DEF codes (Disaster/Emergency Funding codes) to isolate a specific emergency appropriation. DEF codes appear in usaspending_get_award account_obligations_by_defc and usaspending_get_agency def_codes fields. Required: dimension.
usaspending_get_agency(page, agency_slug, toptier_code)
Fetch an agency's fiscal-year overview including mission, budgetary resources, obligation and outlay totals (for the most recent fiscal year), sub-agency count, and DEF codes for disaster/emergency funding. Also returns a paginated sub-agency breakdown with obligation and transaction counts. Accepts either a 3-digit toptier_code (e.g., 097 for DoD, 012 for Agriculture) or an agency_slug (e.g., department-of-defense) — both appear in usaspending_list_agencies results and award search results.
usaspending_get_award(award_id)
Fetch full details of a federal award by its generated unique award ID. Returns contract or assistance award data including recipient info, agency hierarchy, period of performance, place of performance, funding account linkages (account_obligations_by_defc), parent IDV information, and subaward count. Use generated_internal_id values from usaspending_search_awards as input. Recipient hashes can be passed to usaspending_get_recipient; NAICS codes can be used in usaspending_search_awards filters. For IDV-category awards (category="idv"), use usaspending_get_idv_awards to list the child contracts and task/delivery orders placed under them. Required: award_id.
usaspending_get_award_federal_accounts(page, limit, award_id)
List the Treasury federal accounts that funded an award, with the amount obligated from each and the funding agency behind it. This is the award → appropriation link: each row returns federal_account (AGENCY-MAIN format, e.g. 080-0120) to chain into usaspending_get_federal_account for the account budget detail. The award_id must be a generated_unique_award_id — from usaspending_search_awards (generated_internal_id field) or usaspending_get_award. Distinct from usaspending_get_award account_obligations_by_defc, which breaks funding down by Disaster/Emergency Funding code rather than by account. An award_id that does not exist returns an empty list rather than an error. Required: award_id.
usaspending_get_award_subawards(page, sort, limit, order, award_id)
List subaward contracts or grants under a prime federal award. Reveals the sub-contractor or sub-grantee layer — the organizations that actually perform the work. Each row shows the subaward number, amount, description, action date, and recipient. Check subaward_count on usaspending_get_award first to confirm subawards exist before calling this tool. Required: award_id.
usaspending_get_award_transactions(page, sort, limit, order, award_id)
List individual transactions (contract modifications, grant amendments) on a federal award. Each transaction represents a change event — obligation modifications, performance period extensions, scope changes, etc. Use this to trace the spending history and obligation changes over the life of an award. Award IDs come from usaspending_search_awards (generated_internal_id field). Required: award_id.
usaspending_get_federal_account(account_code)
Fetch a federal account's budget data: total obligations, gross outlays, and budgetary resources, plus the per-Treasury-Account-Symbol (TAS) component breakdown in children. Federal accounts connect appropriations law to actual agency spending. Account codes come from usaspending_search_federal_accounts (its account_number output field) or usaspending_get_award_federal_accounts (its federal_account field), and are formatted as AGENCY-MAIN (e.g., 097-0100 for DoD Operation and Maintenance). For obligations broken down by program activity or object class, use usaspending_get_federal_account_breakdown. Required: account_code.
usaspending_get_federal_account_breakdown(page, limit, dimension, account_code)
Fetch a federal account's obligations broken down by program activity (what the money funds) or object class (what it buys — personnel, supplies, contracts). Use the dimension parameter to select the axis. Account codes are AGENCY-MAIN format and come from usaspending_search_federal_accounts (its account_number output field), usaspending_get_award_federal_accounts (its federal_account field), or usaspending_get_federal_account. Paginated with an honest total count. For the account's own metadata and top-level totals, use usaspending_get_federal_account. Required: account_code, dimension.
usaspending_get_idv_awards(page, sort, type, limit, order, award_id)
List child contracts and task/delivery orders placed under an IDV (Indefinite Delivery Vehicle) award. Each row includes the generated_unique_award_id to chain into usaspending_get_award for full detail. The award_id must be the generated_unique_award_id of the parent IDV — obtainable from usaspending_search_awards (generated_internal_id field) or from usaspending_get_award. IDV category awards returned by usaspending_get_award have child orders accessible via this tool. Required: award_id.
usaspending_get_recipient(award_type, fiscal_year, recipient_id)
Fetch a recipient's full profile including address, business type codes, parent organization, alternate names, and total transaction and loan amounts. Recipient IDs are UUID hashes with a level suffix (-P parent, -C child, -R standalone) from usaspending_search_recipients or usaspending_get_award. Optionally scope the totals to a specific fiscal year and award type. UEI and DUNS values can be used to cross-reference with SAM.gov and SEC EDGAR. Required: recipient_id.
usaspending_list_agencies(sort, order)
List all top-tier federal agencies with toptier codes, agency slugs, budget authority amounts, and obligation totals for the current fiscal year. Use this as the entry point for agency navigation — toptier codes and agency slugs are required inputs for usaspending_get_agency and agency-based filters on spending analysis tools.
usaspending_search_awards(page, sort, limit, order, filters, keyword, agency_name, naics_codes, time_period, recipient_name, location_filter, award_type_codes, last_record_unique_id, last_record_sort_value)
Search federal awards by keyword, recipient, agency, award type, NAICS code, location, or date range. Returns ranked award summaries including recipient names, amounts, awarding agencies, and generated award IDs for use with usaspending_get_award. Award types: A/B/C/D = contracts, 02/03/04/05 = grants, 06/10 = direct payments, 07/08 = loans, IDV_A/IDV_B/IDV_C/IDV_D/IDV_E = IDVs. Dates must be ISO 8601 (YYYY-MM-DD). Earliest data: 2007-10-01 via search API. DoD contracts have a 90-day publication lag.
usaspending_search_federal_accounts(page, limit, keyword, sort_field, sort_direction, agency_identifier)
List and keyword-search federal accounts by agency identifier or title keyword. Returns account numbers, names, managing agencies, and budgetary resources. Use account_number from results as input to usaspending_get_federal_account for full budget detail. Use usaspending_list_agencies to look up agency_identifier codes (3-digit strings, e.g. "097" for DoD).
usaspending_search_recipients(page, limit, keyword, award_type)
Search for organizations or individuals receiving federal funds by name, UEI (Unique Entity Identifier), or DUNS. Returns recipient hash IDs, UEI/DUNS identifiers, total award amounts, and hierarchy level. Results are paginated — use page to retrieve matches beyond the first page; page_metadata.total reports the full match count. Recipient hash IDs from this tool can be passed to usaspending_get_recipient for full profiles. Recipient level: P = parent organization, C = child entity, R = standalone. Required: keyword.
usaspending_spending_by_category(page, limit, filters, category)
Aggregate federal spending grouped by a specific dimension: NAICS industry code, PSC product/service code, awarding agency, funding agency, CFDA assistance program, or recipient. Returns top items with obligation amounts — useful for trend and breakdown analysis. Chain NAICS codes into usaspending_search_awards filters or usaspending_autocomplete_filters lookups. Required: category.
usaspending_spending_by_geography(limit, scope, filters, geo_layer, subawards)
Aggregate federal spending by state, county, or congressional district. Useful for per-capita analysis, regional comparisons, and mapping federal investment patterns. Geographic filters accept FIPS codes and 2-letter state abbreviations — NOT place names. Resolve place names to FIPS codes using a geocoding server (Census or OpenStreetMap) before applying location filters. Chain per-capita results with Census population data for meaningful comparisons. Required: scope, geo_layer.
usaspending_spending_over_time(group, filters, subawards)
Fetch aggregated federal obligation amounts grouped by fiscal year, fiscal quarter, or fiscal month. All grouping is relative to the US government fiscal year (Oct–Sep), so fiscal month 1 is October, not January. Filter by award type, agency, recipient, keyword, or NAICS code to trace spending trends in a specific area. Returns per-period totals and optional breakdowns by award category (contracts, grants, direct payments, IDVs, loans, other). Required: group.

Last successful function declaration observed on . Source: https://usaspending.caseyjhand.com/mcp. We list what the server declared; we do not call any of these functions.

Endpoint status observed on . Source: https://usaspending.caseyjhand.com/mcp.

Signals

These are separate measurements of different things. They are deliberately not combined into one score, because a popularity number that mixes website traffic with saves and stars cannot be checked or acted on.

Signal Value What it measures Window Observed Source
GitHub stars 2 Number of GitHub accounts that bookmarked this repository since it was created. It is a bookmark count, not installs, not active users and not quality. cumulative, all time GitHub
Last commit 2026-07-27 Date of the most recent push to any branch. This is the strongest cheap indicator of whether the project is still maintained. point in time GitHub
Open issues 0 Open issues plus open pull requests, as GitHub counts them together. A high number can mean an active project or an abandoned one. as of fetch GitHub
Latest published version 0.4.1 Latest version string the maintainer published to the registry. as of fetch Model Context Protocol
Registry record last updated 2026-07-27 When the registry record was last updated by its maintainer. point in time Model Context Protocol
License Apache-2.0 Licence GitHub detected in the repository. Detection can be wrong; the LICENSE file is authoritative. as of fetch GitHub
First listed in the MCP Registry 2026-07-27 Date this server was first published to the official MCP Registry. Not a usage or quality measure. point in time Model Context Protocol
repository status active The repository exists on GitHub and is not archived. This says nothing about how recently it was worked on. as of fetch GitHub
mcp tools declared 18 tools Number of functions the server itself declared when asked to list them. This is what the server offers an agent, not a measure of how well any of them work. as of probe usaspending.caseyjhand.com
mcp endpoint status ok The server listed 18 functions when asked. as of probe usaspending.caseyjhand.com

Where to get it

Related, by what their authors tagged them

  • Government Contracts MCP — last commit 2026-07-16, shares government-contracts, usaspending
    Government contract search and federal procurement data: SAM.gov opportunities + USASpending awards.
  • Aegis Gov Contracts — last commit 2026-06-13, shares government-contracts
    SAM.gov federal contracts: search, details, AI bid analysis. 33k+ live opportunities.
  • MoltAwards — last commit 2026-04-28, shares government-contracts
    Federal + state government contracts, awards, jobs, and B2B subcontracting for AI agents.
  • io.github.clicksprotocol/mcp-server — last commit 2026-07-21, shares treasury
    Agent commerce settlement tools on Base: treasury setup, payment splits, yield and attribution.
  • io.github.cyanheads/treasury-fiscaldata-mcp-server — last commit 2026-07-30, shares treasury
    MCP server for US Treasury Fiscal Data — debt, interest rates, exchange rates, and spending.
  • io.github.gblinproject/gblin-mcp-server — last commit 2026-08-03, shares treasury
    Collateral-backed treasury vault for AI agents on Base. Crash Shield defends, JIT pays x402.
  • BLS OEWS — last commit 2026-04-25, shares usaspending
    BLS Occupational Employment and Wage Statistics market wages. 7 tools.
  • eCFR — last commit 2026-04-25, shares usaspending
    Electronic Code of Federal Regulations including FAR and DFARS. 13 tools.
  • Federal Register — last commit 2026-04-25, shares usaspending
    Federal Register proposed/final rules, notices, executive orders, FAR cases. 8 tools.
  • GSA CALC+ — last commit 2026-04-25, shares usaspending
    GSA CALC+ awarded labor ceiling rates from 230K+ MAS contracts. 8 tools.

These share tags the maintainers applied themselves, such as government-contracts, usaspending, treasury. Common tags like "mcp" or "ai" are ignored for this: agreeing with six hundred other projects is not a similarity.

This is not a recommendation and not a test result. It is a map of what the authors said their work is about.

Also from cyanheads

How the author describes it

Topics the maintainer set on GitHub: ai-agents, ai-tools, cyanheads, data-act, federal-awards, federal-spending, fiscal-policy, government-contracts, government-grants, government-procurement, mcp, mcp-server, model-context-protocol, treasury, typescript, usaspending.

This record as data

Every field on this page, with its source and observation date, is in the catalog JSON. Fetch the whole kind at once instead of parsing this HTML.

GET /api/v1/entries/mcp_server.json

Sources

  1. cyanheads/usaspending-mcp-server on GitHub — GitHub, observed , trust tier 3.
  2. Official MCP Registry — Model Context Protocol, observed , trust tier 1.
  3. Tools declared by the MCP server at https://usaspending.caseyjhand.com/mcp — usaspending.caseyjhand.com, observed , trust tier 4.