# 1102tools Usaspending Gov MCP server

Source: https://glimind.com/server/mcp-registry%2Fcom.1102tools%2Fusaspending-gov-mcp
Registry id: `mcp-registry/com.1102tools/usaspending-gov-mcp`
Status: live (checked 2026-10-27T02:31:13.375Z)

## Measurements (30 days)

- Uptime: 100%
- Checks: 1307
- Outages (90 days): 0

## Install

```json
{
  "mcpServers": {
    "1102tools-usaspending-gov-mcp-server": {
      "type": "http",
      "url": "https://usaspending.1102tools.com/mcp"
    }
  }
}
```

Claude Code:

```sh
claude mcp add --transport http 1102tools-usaspending-gov-mcp-server https://usaspending.1102tools.com/mcp
```

## Tools (55)

- `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 partia
- `autocomplete_cfda`: Find CFDA (Catalog of Federal Domestic Assistance) program numbers by partial title or program number. CFDA codes are used in grants.
- `autocomplete_funding_agency`: Find funding agency names by partial match (companion to awarding agency).
- `autocomplete_glossary`: Find glossary terms (acquisition + spending vocabulary) by partial match.
- `autocomplete_naics`: Autocomplete lookup for NAICS codes. Accepts partial codes ('541') or keywords ('software'). Returns matching NAICS entries with code and description. Minimum 2
- `autocomplete_psc`: Autocomplete lookup for Product/Service Codes (PSC). Use exact four-character codes ('R499', 'D302') or description keywords ('professional', 'application'). Re
- `autocomplete_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_awar
- `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 
- `get_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, loan
- `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-wi
- `get_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 fi
- `get_agency_object_classes`: List the object class breakdown (what an agency spends money on). Object classes are OMB categories: Personnel Compensation, Travel, Contractual Services, Equip
- `get_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, othe
- `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_b
- `get_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 a
- `get_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 g
- `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 di
- `get_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 re
- `get_award_federal_account_count`: Count of distinct federal accounts (TAS) funding an award.
- `get_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 f
- `get_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 fo
- `get_award_subaward_count`: Count of subawards (FFATA subcontracts/subawards) reported on an award.
- `get_award_transaction_count`: Count of transactions (modifications) on an award.
- `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=Defin
- `get_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
- `get_federal_account_detail`: Get an individual federal account's metadata + budgetary resources.
- `get_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 `a
- `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
- `get_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-y
- `get_glossary`: Get the full USASpending glossary of acquisition + spending terms.
- `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 parameter
- `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 roll
- `get_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
- `get_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.
- `get_idv_funding_rollup`: Funding rollup totals for an IDV (single dict, not paginated).
- `get_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 'Pro
- `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 ha
- `get_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 life
- `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 summ
- `get_submission_periods`: List the reporting calendar and submission/certification deadlines. Returns available fiscal reporting periods and their scheduled start, due, certification and
- `get_transactions`: Fetch the full transaction (modification) history for an award. Every modification, option exercise, and de-obligation is a transaction. Modification number '0'
- `list_federal_accounts`: List Treasury federal accounts (TAS) with budgetary resources. keyword filters by account name or AID. fiscal_year controls the reported budgetary-resource valu
- `list_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 
- `list_toptier_agencies`: List all top-tier federal agencies tracked by USASpending. Returns agency codes, names, abbreviations, and current-year budgetary resources. Use the returned 't
- `lookup_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 a
- `new_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 reci
- `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 
- `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_reci
- `search_subawards`: Search FFATA subaward reports on USASpending. Returns the FFATA subaward records (subcontracts under prime contracts and subawards under prime grants). Compleme
- `spending_by_category`: Aggregate spending by a dimension (top vendors, top agencies, top NAICS, etc.). The 'category' parameter controls the grouping dimension. Common uses: - categor
- `spending_by_geography`: Geographic breakdown of spending. scope: 'recipient_location' (where the recipient is) or 'place_of_performance' (where the work happens). geo_layer: 'state', '
- `spending_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
- `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 
- `spending_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 comp

Measured by Glimind (https://glimind.com): MCP handshake + tool list only, no tool is ever called. CC BY 4.0.