USASpending.gov
OnlineUSAspending.gov contracts, grants, loans, subawards, recipients, agencies, and federal accounts.
What it can do: 55 tools
search_awardsread-onlySearch federal awards (contracts, IDVs, grants, loans, etc.) on USASpending.gov. This is the primary workhorse for finding awards. Returns matching awards with standard fields (Award ID, Recipient, Description,get_award_countread-onlyCount awards matching filters, broken down by award category. Returns counts grouped by: contracts, idvs, grants, loans, direct_payments, other. Use this for dimensional analysis: how many FFP vs T&M awards, howspending_over_timeread-onlyAggregate spending amounts over time, grouped by fiscal year, quarter, or month. Use this to visualize spending trends, identify fiscal-year-end spikes, or compare spending patterns across years. Note: Thespending_by_categoryread-onlyAggregate spending by a dimension (top vendors, top agencies, top NAICS, etc.). The 'category' parameter controls the grouping dimension. Common uses: - category='recipient': top vendors for a filter set (vendorget_award_detailread-onlyFetch full details for a single award by its generated_internal_id. Use the generated_internal_id value returned by search_awards to fetch the complete award record. Returns: PIID, full description, total obget_transactionsread-onlyFetch the full transaction (modification) history for an award. Every modification, option exercise, and de-obligation is a transaction. Modification number '0' is the original base award. Use to understandget_award_fundingread-onlyFetch File C funding data for an award: federal account, object class, program activity. Shows which Treasury accounts, object classes, and program activities funded an award. File C can be partial or lagged; thget_idv_childrenread-onlyFetch child awards (task/delivery orders) under an IDV. For a Multiple Award IDV, child_awards returns the task orders or delivery orders placed against it. For a parent IDV, child_idvs returns the downstrealookup_piidread-onlyLook up awards by their exact PIID, across contracts AND IDVs. Looks for awards whose own PIID is exactly this value (the award_ids filter), in both contracts and IDVs, and says how many share it. match='exaautocomplete_pscread-onlyAutocomplete lookup for Product/Service Codes (PSC). Use exact four-character codes ('R499', 'D302') or description keywords ('professional', 'application'). Returns matching PSC entries with code and descriautocomplete_naicsread-onlyAutocomplete lookup for NAICS codes. Accepts partial codes ('541') or keywords ('software'). Returns matching NAICS entries with code and description. Minimum 2 characters required. Short queries silently mlist_toptier_agenciesread-onlyList all top-tier federal agencies tracked by USASpending. Returns agency codes, names, abbreviations, and current-year budgetary resources. Use the returned 'toptier_code' values with get_agency_overview().get_agency_overviewread-onlyGet descriptive information for an agency: name, mission, website, data notes and DEF codes. It has no dollar figures; for spending use get_agency_obligations_by_award_category() (split by award type) or get_get_agency_awardsread-onlyGet one obligation total and transaction count for an agency's awards in a fiscal year. The total covers ALL award types together (contracts, IDVs, grants, loans, direct payments, other), so for most civiliaget_naics_detailsread-onlyGet details for a NAICS code (2-6 digits). Returns the NAICS description, parent categories, and child subcategories if applicable.get_psc_filter_treeread-onlyGet the PSC hierarchy tree. Pass an empty path for the top-level. Drill down with paths like 'Service/R/' to get the service professional services tree, or 'Product/5' for product codes starting with 5.get_state_profileread-onlyGet the federal award totals for recipients located in a US state. Examples: '06' = California, '48' = Texas, '24' = Maryland, '51' = Virginia. Returns one summary: state name and code, total_prime_amount andsearch_subawardsread-onlySearch FFATA subaward reports on USASpending. Returns the FFATA subaward records (subcontracts under prime contracts and subawards under prime grants). Complementary to the SAM.gov FFATA endpoints but expresspending_by_subaward_groupedread-onlyFind matching prime awards and their cumulative FFATA report totals. Filters select prime records, but subaward_count and subaward_obligation cover all reported subawards under each prime, not just subaward actisearch_recipientsread-onlySearch USASpending recipients (vendors and grantees) by keyword. Returns paginated recipients with their UEI, DUNS, name, and a recipient 'id' hash for get_recipient_profile() and new_awards_over_time(). Forget_recipient_profileread-onlyGet full profile for a recipient by their USASpending hash. Returns recipient details: name, UEI, DUNS, business categories, location, parent (if any), and lifetime award totals. The hash is the 'id' field rget_recipient_childrenread-onlyGet the child recipients (subsidiaries) of a parent recipient. Pass the parent recipient's 12-character UEI (or legacy 9-digit DUNS). Do NOT pass a recipient hash: the /recipient/children/ endpoint is the onautocomplete_recipientread-onlyFind recipient names by partial name or UEI/DUNS. This is a recipient-name lookup; it does not supply the recipient hash for get_recipient_profile() or new_awards_over_time(), and its UEI/DUNS fields may belist_statesread-onlyList all states with their FIPS codes and award totals. Returns the full list of US states/territories with FIPS codes you can pass to get_state_profile(). The /recipient/state/ endpoint returns a JSON arraget_agency_budgetary_resourcesread-onlyGet an agency's budgetary resources by fiscal year. Returns agency budgetary resources, obligations and outlays for each fiscal year on file, plus government-wide budgetary resources and the agency's obligatget_agency_sub_agenciesread-onlyList the subordinate (subtier) organizations of a toptier agency. Returns each sub-agency with its obligations, transaction count, and new-award count for the given fiscal year. Useful for finding the canoniget_agency_federal_accountsread-onlyList the Treasury Account Symbols (federal accounts) used by an agency. Returns each federal account with its obligated amount and gross outlay for the given fiscal year. Useful for understanding how an agency'sget_agency_object_classesread-onlyList the object class breakdown (what an agency spends money on). Object classes are OMB categories: Personnel Compensation, Travel, Contractual Services, Equipment, Grants, etc. Useful for understanding whaget_agency_program_activitiesread-onlyList the program activities (specific programs) within an agency. Program activities are the specific named programs that obligate funds (e.g., 'Cybersecurity and Infrastructure Security Agency'). Useful forget_agency_obligations_by_award_categoryread-onlyGet an agency's obligation breakdown by award category. Returns total obligated dollars split by category: contracts, IDVs, grants, loans, direct payments, other. Quick way to see what mix of award types anget_award_funding_rollupread-onlyGet a rollup of an award's funding totals. Returns total transaction obligated amount, awarding agency count, funding agency count, and federal account count for a single award. Useful for a one-line summaryget_award_subaward_countread-onlyCount of subawards (FFATA subcontracts/subawards) reported on an award.get_award_federal_account_countread-onlyCount of distinct federal accounts (TAS) funding an award.get_award_transaction_countread-onlyCount of transactions (modifications) on an award.awards_last_updatedread-onlyGet the timestamp of the last USASpending award data refresh. Use this to determine data freshness when comparing to other sources (SAM.gov Contract Awards API for example).spending_by_transactionread-onlySearch at the transaction (modification) level. Unlike search_awards which returns one row per award, this returns one row per transaction (initial action plus every modification). Useful for tracking obligaspending_by_geographyread-onlyGeographic breakdown of spending. scope: 'recipient_location' (where the recipient is) or 'place_of_performance' (where the work happens). geo_layer: 'state', 'county', or 'district'. At least one filtenew_awards_over_timeread-onlyPipeline trend of new awards to a recipient over time. REQUIRES recipient_id (the recipient hash with -P suffix for parent-level rollup, or -R for a single recipient). Returns counts of new awards grouped byget_idv_amountsread-onlyTop-line amounts for an Indefinite Delivery Vehicle (IDV). Returns child IDV count, child award count, child award total obligation, and base/option values rolled up across all task/delivery orders under theget_idv_fundingread-onlyList File C funding records associated with an IDV. Rows can identify the IDV itself as well as associated awards; they are not a complete list of child orders. File C coverage can be partial or lagged and d
…and 15 more.
Connect it
claude mcp add --transport http usaspending-gov https://usaspending.1102tools.com/mcpSettings → Connectors → Add custom connector
URL: https://usaspending.1102tools.com/mcp{
"mcpServers": {
"usaspending-gov": {
"url": "https://usaspending.1102tools.com/mcp"
}
}
}{
"servers": {
"usaspending-gov": {
"type": "http",
"url": "https://usaspending.1102tools.com/mcp"
}
}
}Questions
What does USASpending.gov do?
USAspending.gov contracts, grants, loans, subawards, recipients, agencies, and federal accounts. It exposes 55 tools to AI assistants.
What tools does USASpending.gov provide?
55 tools, including search_awards, get_award_count, spending_over_time, spending_by_category, get_award_detail, get_transactions, get_award_funding, get_idv_children, lookup_piid, autocomplete_psc, autocomplete_naics, list_toptier_agencies….
How do I connect USASpending.gov to Claude, ChatGPT or Cursor?
Add the remote MCP endpoint https://usaspending.1102tools.com/mcp as a custom connector or MCP server. Copy-paste setup is on this page.
Does USASpending.gov require an account or API key?
No sign-in was needed to list its tools. Individual tools may still need an account or API key.
Is USASpending.gov online?
As of 2026-11-19 our probe found it online. It answered 100% of our last 3 checks.
Who publishes USASpending.gov?
1102tools.com. The official MCP Registry verified that the publisher controls this domain before accepting the listing.
Similar in Government & Open Data
-
TidesAtlasOnlineOfficialNew
Worldwide tide times and heights, marine weather, sea temperature, sun and moon for 13,000+ ports.
-
ResaleOnlineOfficial
AI-native timeshare marketplace with FL DBPR + CFPB government-source data. Source-linked.
-
Weather MCP Server by MeteosourceOnlineOfficialNew
Forecasts, severe-weather alerts, air quality, 20-year weather history, solar and wind production.
-
Maps CensusOnlineOfficialNew
Statistics on Google Maps businesses by place and business type: counts, shares and online presence.
-
Penguin StatisticsOnlineOfficialNew
Crowdsourced Arknights drop rates by stage and item, for the CN, US, JP and KR game servers
-
Environment & energyOnline
UK river levels and rainfall, bathing waters, flood warnings, weather, earthquakes and the GB…