USASpending.gov
USASpending.gov federal contracts, subawards, recipients, agencies. 55 tools
Reviews
No review yet. Used USASpending.gov? Be the first to help others choose.What it does
USASpending.gov is an MCP server, a connector that lets an AI assistant use it as a tool. It is installed locally as a package and runs on your machine.
No capability identified yet from its description.
Facts come from the Official MCP Registry, as declared by the publisher. Capabilities are matched automatically (low confidence). None of this is a test of the tool.
At a glance
How to connect
As declared in the Official MCP Registry · hosted endpoint tested by Electra Index 2d ago (live check)Hosted endpoint
https://usaspending.1102tools.com/mcpstreamable-http
In Claude Code: claude mcp add --transport http usaspending-gov https://usaspending.1102tools.com/mcp
Install package
- PYPI
usaspending-gov-mcpv0.3.2 · runs locally (stdio)
MCP settings (Claude Desktop, Cursor and other MCP clients)
{
"mcpServers": {
"usaspending-gov": {
"url": "https://usaspending.1102tools.com/mcp"
}
}
}Live check
Electra Index connected to the hosted endpoint 2d agoONLINE USASpending.gov answered an MCP connection on 15 Nov 2026 and introduced itself as usaspending 1.0.29 (MCP protocol 2025-06-18).
55 tools offered to AI assistants
search_awards· Search 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, Amount, Agencies, NAICS, PSC,get_award_count· Count 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, how many competed vs sole-sourcespending_over_time· Aggregate 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: The API returns fiscal_year as a STRINspending_by_category· Aggregate 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 (vendor landscape analysis) - categoget_award_detail· Fetch 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 obligation, recipient details, pareget_transactions· Fetch 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 understand the full lifecycle of a contractget_award_funding· Fetch 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; these rows do not establish theget_idv_children· Fetch 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 downstream IDV structure. grandchild_awardlookup_piid· Look 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='exact' rows are the awards themselveautocomplete_psc· Autocomplete 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 description. Two-character families sucautocomplete_naics· Autocomplete 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 match substrings inside parentheticlist_toptier_agencies· List 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().
Show 43 more
get_agency_overview· Get 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_agency_budgetary_resources() (obget_agency_awards· Get 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 civilian agencies it is far larger thanget_naics_details· Get details for a NAICS code (2-6 digits). Returns the NAICS description, parent categories, and child subcategories if applicable.get_psc_filter_tree· Get 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_profile· Get 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 and total_prime_awards (all award tsearch_subawards· Search 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 expressed at the USASpending data modelspending_by_subaward_grouped· Find 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 actions within time_period_start/search_recipients· Search 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(). For get_recipient_children(), use thget_recipient_profile· Get 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 returned by search_recipients(). (get_recipient_children· Get 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 one recipient endpoint keyed by UEIautocomplete_recipient· Find 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 be null. Pass a returned name to sealist_states· List 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 array (not an object). We wrap it in {get_agency_budgetary_resources· Get 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 obligations by reported fiscal period. Tget_agency_sub_agencies· List 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 canonical subtier name to pass into seaget_agency_federal_accounts· List 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's money flows through Treasuryget_agency_object_classes· List 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 what types of expenditures an agencyget_agency_program_activities· List 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 for pinpointing which program fundsget_agency_obligations_by_award_category· Get 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 an agency uses (heavy contractor ageget_award_funding_rollup· Get 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 summary of an award's funding picture.get_award_subaward_count· Count of subawards (FFATA subcontracts/subawards) reported on an award.get_award_federal_account_count· Count of distinct federal accounts (TAS) funding an award.get_award_transaction_count· Count of transactions (modifications) on an award.awards_last_updated· Get 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_transaction· Search 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 obligation events over time, ceiling adspending_by_geography· Geographic 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 filter is required. The API returns HTTP 50new_awards_over_time· Pipeline 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 by month, quarter, or fiscal year.get_idv_amounts· Top-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 the IDV. Pass a CONT_IDV_* generatedget_idv_funding· List 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 does not establish the full child-get_idv_funding_rollup· Funding rollup totals for an IDV (single dict, not paginated).get_idv_activity· List child task/delivery orders awarded under an IDV. Results are ALWAYS sorted by obligated amount, descending; the endpoint accepts no sort or order parameters. (Earlier releases exposed sort/order here, but the API silently ignored them:autocomplete_awarding_agency· Find awarding agency names by partial match. USASpending search filters require the EXACT awarding agency name (slugs return zero). Use this to resolve a partial name to the canonical one before passing to search_awards() awarding_agency paautocomplete_funding_agency· Find funding agency names by partial match (companion to awarding agency).autocomplete_cfda· Find CFDA (Catalog of Federal Domestic Assistance) program numbers by partial title or program number. CFDA codes are used in grants.autocomplete_glossary· Find glossary terms (acquisition + spending vocabulary) by partial match.get_award_types_reference· Return the full mapping of award type codes to descriptions. Returns the canonical reference: contracts (A=BPA Call, B=Purchase Order, C=Delivery Order, D=Definitive Contract), IDVs, grants, loans, etc. Authoritative source if you're unsureget_def_codes_reference· Return all Disaster Emergency Fund (DEFC) codes with public laws. DEFCs are used to filter awards funded by specific supplemental appropriations (COVID-19, IIJA, IRA, etc.).get_glossary· Get the full USASpending glossary of acquisition + spending terms.get_submission_periods· List the reporting calendar and submission/certification deadlines. Returns available fiscal reporting periods and their scheduled start, due, certification and reveal dates. These are global calendar periods, not records of when individuallist_federal_accounts· List Treasury federal accounts (TAS) with budgetary resources. keyword filters by account name or AID. fiscal_year controls the reported budgetary-resource values, not which account rows are included. When omitted, the source uses its latesget_federal_account_detail· Get an individual federal account's metadata + budgetary resources.get_federal_account_object_classes· Get the object class breakdown of obligations for a federal account. IMPORTANT: the returned obligations are CUMULATIVE across all reported fiscal years (FY2017 onward, the DATA Act window), not a single year. They are NOT comparable to getget_federal_account_program_activities· List program activity codes and names associated with a federal account. The source lists distinct programs across all reported fiscal years; it has no fiscal-year filter and includes no dollar amounts. fiscal_year is retained for compatibiget_federal_account_fy_snapshot· Get a single-fiscal-year snapshot of a federal account's resources. Important: this endpoint takes the numeric `account_id` (e.g. 4595), NOT the alphanumeric `account_number` (e.g. "027-5183") used by the other federal-account endpoints. Th
What "online" means: the server answered an MCP connection at the time of the check. It is not a guarantee of security, quality or continuous uptime. How we test: we open an MCP session and ask for the tool list, as an AI assistant would. We never run a tool and never send a key. Checked every few days. Method
Is this your server? Monitoring Pro: a check every 30 minutes and an email within the hour when it stops answering. Launch offer: $39.99 once, for life.
Facts & evidence
Each fact shows where it was seen and when.| Fact | Value | Evidence | Source | Last confirmed |
|---|---|---|---|---|
| Install package | usaspending-gov-mcp | DECLARED | SRC-001 Official MCP Registry | 1d ago |
| Remote access (hosted) | no | DECLARED | SRC-001 Official MCP Registry | 1d ago |
| Repository | https://github.com/1102tools/federal-contracting-mcps | DECLARED | SRC-001 Official MCP Registry | 1d ago |
| Version | 1.0.29 | DECLARED | SRC-001 Official MCP Registry | 1d ago |
| Hosted endpoint | https://usaspending.1102tools.com/mcp | DECLARED | SRC-001 Official MCP Registry | 1d ago |
| Package registries | pypi | DECLARED | SRC-001 Official MCP Registry | 1d ago |
| Local install (package) | yes | DECLARED | SRC-001 Official MCP Registry | 1d ago |
| Website | https://1102tools.com | DECLARED | SRC-001 Official MCP Registry | 1d ago |
| Registry status | active | DECLARED | SRC-001 Official MCP Registry | 1d ago |
| MCP server | yes | DECLARED | SRC-001 Official MCP Registry | 1d ago |
Change history
- CHANGED16 Nov 2026remote access: yes → no
- CHANGED16 Nov 2026remote access: no → yes
- CHANGED09 Nov 2026remote access: yes → no
- CHANGED03 Nov 2026remote access: no → yes
- VERSION03 Nov 20261.0.28 → 1.0.29
- CHANGED02 Nov 2026remote access: yes → no
- CHANGED27 Oct 2026remote access: no → yes
- VERSION27 Oct 20261.0.27 → 1.0.28
- CHANGED26 Oct 2026remote access: yes → no
- VERSION26 Oct 20261.0.27 → 0.3.2
- CHANGED21 Oct 2026remote access: no → yes
- VERSION21 Oct 20260.3.2 → 1.0.27
- VERSION19 Oct 20261.0.26 → 0.3.2
- VERSION12 Oct 20261.0.25 → 1.0.26
- VERSION12 Oct 20260.3.2 → 1.0.25
- VERSION12 Oct 20261.0.24 → 0.3.2
- VERSION11 Oct 20261.0.23 → 1.0.24
- VERSION10 Oct 20261.0.22 → 1.0.23
- VERSION10 Oct 20261.0.21 → 1.0.22
- VERSION10 Oct 20261.0.20 → 1.0.21
- VERSION10 Oct 20261.0.19 → 1.0.20
- VERSION10 Oct 20261.0.17 → 1.0.19
- VERSION10 Oct 20261.0.16 → 1.0.17
- VERSION10 Oct 20261.0.15 → 1.0.16
- VERSION10 Oct 20261.0.14 → 1.0.15
- VERSION10 Oct 20261.0.13 → 1.0.14
- VERSION10 Oct 20261.0.12 → 1.0.13
- VERSION10 Oct 20261.0.11 → 1.0.12
- VERSION10 Oct 20261.0.10 → 1.0.11
- VERSION09 Oct 20260.3.2 → 1.0.10
Is this page accurate?
Flag it and our robot re-checks the official source. Reports never change a score.Is USASpending.gov still online?
Free alerts · no account▲ 0Do you publish USASpending.gov? Get it seen by people choosing a tool
For publishers · optionalLaunch Spotlight: 60 days of clearly labelled Sponsored visibility on the use-case pages where USASpending.gov already appears, plus the weekly Pulse. No click in 60 days? The next 60 days are free.
Sponsored placements never change a score or a rank.
Questions about USASpending.gov
How do I connect USASpending.gov?
Use the hosted endpoint https://usaspending.1102tools.com/mcp in your assistant's MCP settings. The exact settings are in "How to connect" above, as declared in the Official MCP Registry.
What tools does USASpending.gov offer?
When Electra Index connected on 15 Nov 2026, it listed 55 tools: search_awards, get_award_count, spending_over_time, spending_by_category, get_award_detail, get_transactions, get_award_funding, get_idv_children and more. The full list is in "Live check" above.
Is USASpending.gov online?
Yes. Its hosted endpoint answered an MCP connection from Electra Index 2d ago.