MCP server

USASpending.gov

com.1102tools/usaspending-gov-mcp

Checked 26 Oct 2026, 08:29 UTC · Connected to it and listed its tools

USAspending.gov contracts, grants, loans, subawards, recipients, agencies, and federal accounts.

Website Source

At a glance

Type

MCP server

Publisher

1102tools.com (verified by the MCP Registry)

Status

Working at last check

Tools

55

Token cost

About 18,350 tokens per request

Sets up in

Claude Code, Claude Desktop, Codex, Gemini CLI, Cursor, VS Code, Antigravity, ChatGPT, OpenAI API, Grok

Last checked

26 Oct 2026, 08:29 UTC

Connect it to your agent

Add to CursorAdd to VS CodeVS Code Insiders

Opens the app, which shows the server and asks you to confirm. For other apps, copy the setup below.

Claude Code

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

Claude Desktop

Settings → Connectors → Add custom connector, and paste the URL.

Codex (config.toml)

[mcp_servers.usaspending-gov-mcp]
url = "https://usaspending.1102tools.com/mcp"

Gemini CLI

{"mcpServers":{"usaspending-gov-mcp":{"httpUrl":"https://usaspending.1102tools.com/mcp"}}}

Cursor

{"mcpServers":{"usaspending-gov-mcp":{"url":"https://usaspending.1102tools.com/mcp"}}}

VS Code

{"servers":{"usaspending-gov-mcp":{"type":"http","url":"https://usaspending.1102tools.com/mcp"}}}

Antigravity

agy mcp add usaspending-gov-mcp https://usaspending.1102tools.com/mcp

ChatGPT

Settings → Apps & Connectors → Advanced settings: turn on Developer mode, then Create a connector and paste the URL. Which plans can do this varies.

OpenAI API (Responses tools)

{"type":"mcp","server_label":"usaspending-gov-mcp","server_url":"https://usaspending.1102tools.com/mcp","require_approval":"always"}

Grok (xAI API tools)

{"type":"mcp","server_label":"usaspending-gov-mcp","server_url":"https://usaspending.1102tools.com/mcp"}

Tools

• autocomplete_awarding_agency ~160 tokens
  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 parameter.
• autocomplete_cfda ~116 tokens
  Find CFDA (Catalog of Federal Domestic Assistance) program numbers by partial title or program number. CFDA codes are used in grants.
• autocomplete_funding_agency ~104 tokens
  Find funding agency names by partial match (companion to awarding agency).
• autocomplete_glossary ~100 tokens
  Find glossary terms (acquisition + spending vocabulary) by partial match.
• autocomplete_naics ~264 tokens
  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 parenthetical notes (e.g. 'x' matches 'except') and p
• autocomplete_psc ~292 tokens
  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 such as 'D3' can return no autocomplete matche
• autocomplete_recipient ~198 tokens
  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 search_recipients(): use its 'id' hash for pro
• awards_last_updated ~94 tokens
  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).
• get_agency_awards ~295 tokens
  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 than contract spending (VA FY2026: $313B here vs
• get_agency_budgetary_resources ~166 tokens
  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. This endpoint does not provide a discretiona
• get_agency_federal_accounts ~329 tokens
  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 Treasury. fiscal_year defaults to the last complet
• get_agency_object_classes ~330 tokens
  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 agency makes. fiscal_year defaults to the last c
• get_agency_obligations_by_award_category ~301 tokens
  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 agency vs grant-issuing agency vs mixed). For
• get_agency_overview ~283 tokens
  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() (obligations and outlays by year). toptier_cod
• get_agency_program_activities ~336 tokens
  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 funds a specific activity. fiscal_year defaults
• get_agency_sub_agencies ~398 tokens
  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 search_awards() awarding_subagency. sort acce
• get_award_count ~1286 tokens
  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-source, how many small business set-asides, etc.
• get_award_detail ~325 tokens
  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, parent award info, latest transaction contract
• get_award_federal_account_count ~83 tokens
  Count of distinct federal accounts (TAS) funding an award.
• get_award_funding ~264 tokens
  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 the full award obligation or amount paid to the co
• get_award_funding_rollup ~137 tokens
  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 ~82 tokens
  Count of subawards (FFATA subcontracts/subawards) reported on an award.
• get_award_transaction_count ~78 tokens
  Count of transactions (modifications) on an award.
• get_award_types_reference ~125 tokens
  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 unsure what a code letter means.
• get_def_codes_reference ~96 tokens
  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_federal_account_detail ~86 tokens
  Get an individual federal account's metadata + budgetary resources.
• get_federal_account_fy_snapshot ~215 tokens
  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. The list_federal_accounts response includes b
• get_federal_account_object_classes ~272 tokens
  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 get_federal_account_fy_snapshot(), which is si
• get_federal_account_program_activities ~329 tokens
  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 compatibility, but does not filter this list. The respon
• get_glossary ~85 tokens
  Get the full USASpending glossary of acquisition + spending terms.
• get_idv_activity ~279 tokens
  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: the advertised default of period_of_perfor
• get_idv_amounts ~136 tokens
  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_* generated_internal_id.
• get_idv_children ~445 tokens
  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_awards walks the hierarchy. Field name differen
• get_idv_funding ~278 tokens
  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-order obligation or amount paid. Use get_id
• get_idv_funding_rollup ~79 tokens
  Funding rollup totals for an IDV (single dict, not paginated).
• get_naics_details ~97 tokens
  Get details for a NAICS code (2-6 digits). Returns the NAICS description, parent categories, and child subcategories if applicable.
• get_psc_filter_tree ~118 tokens
  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_recipient_children ~343 tokens
  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 UEI/DUNS, and it rejects hashes with HTTP 400.
• get_recipient_profile ~279 tokens
  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(). (autocomplete_recipient does NOT return hash
• get_state_profile ~341 tokens
  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 types together), loan face value, award_amou
• get_submission_periods ~150 tokens
  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 individual agencies actually submitted or certified d
• get_transactions ~269 tokens
  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 contract including its descriptive text at each poin
• list_federal_accounts ~292 tokens
  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 latest available fiscal year, which may differ f
• list_states ~141 tokens
  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 {"results": [...]} to keep the tool return
• list_toptier_agencies ~104 tokens
  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().
• lookup_piid ~491 tokens
  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 themselves: an IDV PIID returns the IDV (award_type=
• new_awards_over_time ~298 tokens
  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. The endpoint rejects calls without recipie
• search_awards ~1468 tokens
  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, dates). Use get_award_detail() with the genera
• search_recipients ~314 tokens
  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 the UEI (or legacy DUNS) from the parent (-P)
• search_subawards ~306 tokens
  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 model. award_id: optional generated_internal_id
• spending_by_category ~1323 tokens
  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) - category='awarding_subagency': which contracting offi
• spending_by_geography ~618 tokens
  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 500 on an empty filter set, so the requi
• spending_by_subaward_grouped ~892 tokens
  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/end. This ranking is not a fiscal-period su
• spending_by_transaction ~819 tokens
  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 adjustments, deobligations, and admin mods.
• spending_over_time ~1241 tokens
  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 STRING. Cast to int for numeric comparisons. qu

Browse

• Payments
• Databases
• Travel and flights
• Government and public data

Related MCP servers

• Usaspending
  Access US federal award, recipient, agency, and spending analytics data from USAspending.gov.
• Crypto, web, finance and app data tools
  179 tools: crypto, EVM, SEC, FDA, NHTSA VIN, NWS weather, Eurostat, FRED, cloud & LLM prices, DNS.
• LiveDataLink
  294 public-data tools across 60 domains; source freshness varies. Free tier.
• Govparse Government Data Gateway
  Pay-per-call US government data: carrier safety, visa sponsors, contracts, employer risk.
• SiteCheck Company Records
  120 pay-per-call agent tools: company registry, government, legal and B2B data tools. x402
• Edgrapi Skills
  US government + SEC data as clean JSON: SAM.gov, USAspending, Grants.gov, Congress, SEC filings.
• ScorpTech x402 API
  112 x402 pay-per-call tools: web data, security/OSINT, SEC and public data, Solana/EVM lookups
• Gouda Studios Agent Tools
  Pay-per-result SAM.gov contracts, SEC EDGAR filings, USAspending awards and GLEIF LEI lookups.

Badge for your README

[![AptLynx](https://aptlynx.net/badge/com.1102tools/usaspending-gov-mcp.svg)](https://aptlynx.net/servers/com.1102tools/usaspending-gov-mcp)

Listing text is written by the maker; AptLynx lists tools and does not vouch for them. Find another tool · Browse by topic · For agents