USAspending (Federal Spending) MCP for AI. Map money flow across agencies, states, and years.
Works with every AI agent you already use
…and any MCP-compatible client








Connect to your AI in seconds.
USAspending (Federal Spending) analyzes US federal spending data, letting you query agency budgets, track contract awards, and map financial flows across any geography directly via your agent.
This server gives you deep visibility into how the U.S. government allocates its budget—from high-level department overviews to specific sub-agency obligations and transaction records.
You can filter millions of federal grants and contracts using advanced criteria based on recipients, locations, or time periods.
What your AI can do
Autocomplete awarding agency
Suggests full names for federal agencies matching a search text.
Autocomplete glossary
Provides definitions and suggestions based on glossary terms you type in.
Autocomplete location
Suggests specific states, counties, or districts when searching for geography.
Retrieves an agency's total available budget and current obligation amounts across specified fiscal years.
Filters and aggregates spending data based on specific states, counties, or congressional districts.
Retrieves full details for a single federal award, including its funding source and associated sub-awards.
Identifies all internal offices or sub-agencies within a department and reports their obligated spending amounts.
Generates ZIP files containing large data sets of awards, transactions, or subawards in CSV format for external analysis.
Provides dedicated insights into emergency and disaster-related spending across government agencies.
Ask an AI about this
Waiting for input…
USAspending (Federal Spending) MCP Server: 32 Tools for Financial Analysis
Use these specialized tools to pull raw financial data on federal spending, tracking everything from budgets and obligations to specific contract details across the U.S.
Make your AI actually useful.
Add this MCP to Claude, Cursor, or Windsurf and your AI stops guessing. It gets real tools to look things up, take action, and handle the stuff you keep doing by hand.
Start using USAspending (Federal Spending) on VinkiusAutocomplete Awarding Agency
Suggests full names for federal agencies matching a search text.
Autocomplete Glossary
Provides definitions and suggestions based on glossary terms you type in.
Autocomplete Location
Suggests specific states, counties, or districts when searching for geography.
Autocomplete Recipient
Provides names and Unique Entity Identifiers (UEI) for recipients based on search...
Bulk Download Awards
Creates a ZIP file containing all selected award data, including subawards, in CSV...
Download Search
Generates a single ZIP file download covering awards, subawards, and transactions for a search query.
Get Agency Awards Count
Counts the number of different award types for an agency within a specified fiscal year.
Get Agency Awards
Summarizes all transactions and obligations related to a specific federal agency.
Get Agency Budgetary Resources
Retrieves detailed budgetary resources and obligations totals for an agency by...
Get Agency Overview
Pulls a general summary page of data for any major federal agency.
Get Agency Sub Agencies
Lists all offices and sub-agencies under an agency, showing how much money they've...
Get Award Funding
Shows the specific federal account and agency funding details for an award.
Get Award
Retrieves detailed information about a single federal award record.
Get Award Types
Maps out different types of awards by grouping them into categories.
Get Data Dictionary
Outputs the JSON structure used for the Rosetta Crosswalk Data Dictionary, defining...
Get Disaster Agency Spending
Provides spending insights specifically for agencies receiving disaster funding.
Get Disaster Award Amount
Aggregates the obligation and outlay amounts for awards issued in response to...
Get Disaster Overview
Gives a broad overview of spending related to general disaster or emergency funding.
Get Download Status
Checks the current status of any large data download job you requested.
Get Glossary
Lists all available glossary terms and their official definitions used in the...
Get Recipient Children
Gets detailed recipient information based on a provided identifier key.
Get Recipient State
Provides basic geographic information for a specified state.
Get Recipient
Retrieves basic details about an individual recipient listed in the database.
Get Subawards
Lists all sub-award details that fall under a single, main parent award.
Get Toptier Agencies
Retrieves data for all designated 'top tier' government agencies and their key metrics.
Get Transactions
Lists specific financial transactions that occurred against a parent award.
List Recipients
Returns the full list of all entities recorded as recipients in the database.
Search New Awards Over Time
Lists time periods and counts how many new awards were issued during those specific...
Search Spending By Award
Allows you to search and filter for federal awards using multiple criteria.
Search Spending By Category
Groups spending data by category, agency, or recipient type for visualization purposes.
Search Spending By Geography
Finds and filters spending amounts specifically by state, county, or congressional district.
Search Spending Over Time
Aggregates transaction dollar amounts over different historical time periods.
Security and governance baked right in.
Pick your AI client below to get set up. Just create a Vinkius account, subscribe, and you're instantly up and running. We handle the entire backend infrastructure, delivering out-of-the-box support for HTTPS Streamable, SSE, and OAuth2—zero messy routing required.
Choose How to Get Started
Build a custom MCP for your own tools, or connect a ready-made integration from our catalog.
Build Your Own
Turn any API into an MCP. Import a spec, define Agent Skills, or deploy with MCPFusion.
- Import from OpenAPI, Swagger, or YAML specs
- Create Agent Skills with progressive disclosure
- Deploy to edge with MCPFusion framework
- Built in DLP, auth, and compliance on every call
- Real time usage dashboard and cost metering
- Publish to catalog or keep private
Make Your AI Do More
Start with USAspending (Federal Spending), then connect any of our 5,100+ other servers whenever your AI needs more. One click, no limits.
- Use this MCP plus 5,100+ others, all in one place
- Add new capabilities to your AI anytime you want
- Every connection is secured and compliant automatically
- Track usage and costs across all your servers
- Works with Claude, ChatGPT, Cursor, and more
- New servers added to the catalog every week
Independent Platform Disclaimer: Vinkius is an independent platform and is not affiliated with, endorsed by, sponsored by, verified by, or otherwise authorized by USAspending. All third-party trademarks, logos, and brand names are the property of their respective owners. Their use on this website is strictly for informational purposes to identify service compatibility and interoperability.
VINKIUS INFRASTRUCTURE
Cloud Hosted
Managed infra
V8 Isolated
Sandboxed per request
Zero-Trust Proxy
No stored credentials
DLP Enforced
Policy on every call
GDPR Compliant
EU data residency
Token Compression
~60% cost reduction
Works with Claude, ChatGPT, Cursor, and more
The Model Context Protocol standardizes how applications expose capabilities to LLMs. Instead of operating in isolation, your AI gains direct access to external platforms, live data, and real-world actions through secure, standardized connections.
This connection provides 32 powerful capabilities that interface natively with Claude, ChatGPT, Cursor, and other compatible AI platforms. No middleware. No custom integration required.
Finding a contract recipient shouldn't require five different database tabs.
Right now, if you want to know who got federal money, you typically start on the main agency site. Then, you search for the year in the annual report PDF, cross-reference that number with a secondary awards tracker, and finally, copy the name into a spreadsheet just to confirm their UEI.
With this MCP server, you simply tell your agent: 'Give me all recipients who got over $1M from DoD last quarter.' The system runs through `autocomplete_recipient` for validation, executes `search_spending_by_award`, and spits out the clean list—no manual copy-pasting involved.
USAspending (Federal Spending) MCP Server: Get a full financial picture.
The most tedious part is correlating spending. You can't just look at total agency funds; you need to know how much of that was allocated to sub-agencies, and then which specific contracts funded those sub-offices. This used to be a full-time job for an analyst.
Now, your agent runs `get_agency_sub_agencies` first. It lists the internal offices and their obligations. Then, it can cross-reference that data with `get_transactions`, giving you the granular proof of where every dollar is actually accounted for.
What your AI can actually do with this
USAspending MCP Server - Federal Spending Analysis
Listen up. This server connects you directly to the official USAspending database. Your agent uses it to pull real-time financial data showing exactly how the U.S. government spends its cash. You're not just looking at totals; you're tracking every single dollar, from major department budgets down to a specific transaction record.
It gives you deep visibility into federal money flows.
Agency Deep Dives and Budget Status
You wanna know what an entire department's up to? You pull a general summary page for any major agency using get_agency_overview. For the full picture, your agent can retrieve detailed budgetary resources and current obligation amounts across multiple fiscal years via get_agency_budgetary_resources, or it can summarize all transactions tied to one specific federal group with get_agency_awards.
If you're looking at a 'top tier' department, get_toptier_agencies gives you the key metrics for all designated government giants. To drill down further, you can use get_agency_sub_agencies to list every internal office or sub-agency under that big department and see exactly how much money they've obligated. You also get a count of different award types an agency managed in a given year using get_agency_awards_count.
For agencies handling emergency situations, you can run dedicated checks: get_disaster_overview gives broad insights into general disaster funding, and get_disaster_agency_spending focuses on specific spending related to those emergencies. You'll also get the aggregated obligation and outlay amounts for awards issued after a crisis using get_disaster_award_amount.
Tracking Specific Awards and Money Flows
You can track everything that happens with any single contract or grant. Use get_award to pull all the detailed info on one federal award record, including its original funding source via get_award_funding. You wanna see what kind of money it is? get_award_types maps out different categories of awards for you.
If an award has sub-contracts, you use get_subawards to list those details that fall under the main parent agreement. To get the granular breakdown, your agent lists specific financial transactions against a parent award using get_transactions. You can also check how many new awards came in over time by running search_new_awards_over_time, or you can find out which agency awarded an amount of money at a glance with get_agency_awards.
Filtering Data Across Scope, Location, and Time
The data is massive, so you gotta filter it down. You don't wanna look at everything; you want to know where the cash went. Use search_spending_by_geography to find and filter spending amounts specifically by state, county, or congressional district—it pinpoints exactly where money landed.
For a historical view, run search_spending_over_time to aggregate dollar amounts across different years. You can also search for federal awards using multiple criteria with search_spending_by_award, or group all spending data by category, agency type, or recipient type for visualization purposes via search_spending_by_category. When you need to narrow down the recipients, your agent uses autocomplete_recipient and then pulls basic details about them with get_recipient, or gets deep info on their corporate structure using get_recipient_children.
Data Utility and Downloads
If you're working with millions of records, you gotta get the data out. Your agent can generate a single ZIP file download covering awards, subawards, and transactions for any search query via download_search. If you just need one type of record, you can make a big package containing all selected award data—including subawards—and zip it up in CSV format using bulk_download_awards.
You can also check on those large downloads anytime with get_download_status. Need to autocomplete something? Use autocomplete_awarding_agency for agency names, or autocomplete_location when searching by geography. For definitions, the server gives you get_glossary and autocomplete_glossary to make sure you're using the right terminology; it also lists all available glossary terms via get_data_dictionary.
Finally, if you just wanna see who's in the system, list_recipients returns the full list of every entity recorded as a recipient.
019e3904-54a9-7053-b48d-6ac7babd07f0 Here's how it actually works
The bottom line is, you don't have to manually click through agency sites or download massive files; your AI client handles the complex data retrieval chain for you.
Subscribe to the USAspending server. If you hit rate limits, provide your API key.
Prompt your agent with a research question (e.g., 'How much did Texas receive in 2023?').
The agent executes multiple tools—like search_spending_by_geography and then get_award—and synthesizes the final answer.
Who is this actually for?
Policy researchers and investigative journalists need this. If you’re constantly jumping between a department's main website, an annual report, and a separate database just to figure out where money actually went, this server saves your sanity. It cuts through the bureaucracy.
Checks specific agency resource levels or tracks how obligations shift between departments year over year using get_agency_budgetary_resources.
Tracks federal contracts and grants in a specific region or sector, filtering through award criteria to find connections via search_spending_by_geography.
Gathers data on sub-agency spending distribution within large departments—like listing every office under the Department of Justice using get_agency_sub_agencies.
What Changes When You Connect
You can calculate spending patterns by category grouping using search_spending_by_category. This moves beyond simple totals and shows where the funds are allocated conceptually.
Tracking geographic distribution is easy. Use search_spending_by_geography to instantly see how federal money broke down across counties or states, eliminating manual map cross-referencing.
Need a detailed financial history? The tools let you pull both total budgets (get_agency_budgetary_resources) and the specific transactions that make up those numbers (get_transactions).
When investigating major contracts, use get_award combined with get_subawards. This shows not only the main grant amount but also every small project funded beneath it.
You don't have to download everything. If you just need a summary of an agency’s overall health and obligations, run get_agency_overview; it gives you the top line in seconds.
See it in action
Investigating State-Level Spending Discrepancies
A policy researcher wants to know if a certain state, like Florida, is getting its fair share of disaster funds. They start with get_disaster_overview to see the national picture, then run search_spending_by_geography specifically for their state and compare it against historical spending found via search_spending_over_time. The agent compiles a report showing the exact percentage increase or decrease.
Tracing Contract Funding Chains
A journalist finds an award number. To write a story, they use get_award to get basic details. They then run get_award_funding to pinpoint the source account and agency funding. Finally, running get_subawards reveals all the smaller contractors involved in that single mega-contract.
Comparing Department Budgets
A consultant needs to compare two major departments—say, Homeland Security and Defense—for budgetary health. They run get_agency_budgetary_resources for both using different fiscal years and then use get_agency_sub_agencies on each one to see which department's internal components are spending the most.
Analyzing Small Business Grant Recipients
A small business advocate wants a list of who received grants. They run list_recipients and filter by recipient type, then use autocomplete_recipient to check for specific company names. To verify the spending, they might run search_spending_by_award against those recipients.
The honest tradeoffs
Trying to download everything at once
Calling download_search without first defining a narrow search scope. You end up with hundreds of megabytes of data, and you still have to clean it yourself.
Don't use bulk tools until you know your boundaries. First, run get_agency_overview to identify the core agency (e.g., Department of Energy). Then, narrow down by running search_spending_by_category before attempting any download.
Forgetting the time frame
Running a simple search for 'awards' without specifying a fiscal year. The data might be mixed up or incomplete, giving you old numbers.
Always use date-specific tools. Use get_agency_budgetary_resources and pass in the exact start and end years. This anchors your entire analysis to accurate time bounds.
Mixing recipient data with spending data
Trying to guess a company's funding status by just running get_recipient. The tool only gives basic details, not the actual financial obligations.
Use autocomplete_recipient first to get an accurate UEI. Then, use that identifier in conjunction with search_spending_by_award or get_agency_awards to link the recipient directly to a specific amount.
When It Fits, When It Doesn't
You should use this server if your core task is tracing money: who got it, how much, where did it go, and when. If you need that deep level of federal financial transparency—checking obligations across agencies or sub-agencies—this is the tool.
Don't use this if you are just looking for general public knowledge (e.g., 'What is a grant?'). For definitions, use get_glossary. If your goal is simple data manipulation (like basic text parsing), don't rely on spending tools; stick to dedicated data processing utilities. This server requires complex queries that link multiple entities: Agency -> Award -> Sub-Agency/Recipient -> Geography.
Questions you might have
How do I see all funding sources for a specific contract using get_award_funding? +
Run get_award_funding and provide the award ID. This function returns the exact federal account code, agency responsible, and the source of the money used for that particular award.
Can I track spending by state or county using search_spending_by_geography? +
Yes. Use search_spending_by_geography and specify the desired state, county, or congressional district. The tool aggregates all relevant transactions for that exact region.
What is the difference between get_agency_awards and search_spending_by_award? +
get_agency_awards gives a summary of obligations and transactions for an entire agency. search_spending_by_award lets you narrow down the focus using specific criteria like recipient names or award types.
How do I see what sub-offices are spending money under one department? Use get_agency_sub_agencies. +
Run get_agency_sub_agencies and specify the parent agency ID. This lists every internal office, along with the specific obligated dollar amounts for each.
I need to see what new contracts were issued over time. Use search_new_awards_over_time. +
The search_new_awards_over_time tool lists periods and counts the number of awards that were newly created in those specific time frames.
What should I do if I get an error when running `get_agency_overview`? +
First, verify your USAspending API Key is active and correctly configured. If the key works but you hit an error, it usually means you've reached a rate limit. You need to use the provided API Key for high-volume querying to keep the connection stable.
How do I understand all the field codes before running complex searches like `search_spending_by_category`? +
get_data_dictionary provides the full JSON structure of the Rosetta Crosswalk Data Dictionary. This tool lets your agent map specific fields and data types correctly, which prevents inaccurate queries and improves search results.
For processing huge datasets, should I use `bulk_download_awards` or run many individual searches? +
You should use bulk_download_awards. It generates a single ZIP file containing all requested award data in CSV format. This is significantly faster for offline analysis than making dozens of iterative API calls.
How do I get an overview of a specific agency's spending? +
Use the get_agency_overview tool by providing the agency's toptier code. The agent will return high-level data including total obligations and budgetary resources.
Can I see which sub-agencies are spending the most within a department? +
Yes! The get_agency_sub_agencies tool lists all sub-agencies and offices associated with a toptier agency, along with their respective obligated amounts.
Is it possible to filter federal awards by geographic location? +
Absolutely. Use search_spending_by_geography to aggregate spending data by state, county, or district, or use search_spending_by_award with geographic filters.
We've already built the connector for USAspending (Federal Spending). Just plug in your AI agents and start using Vinkius.
No hosting. No infrastructure. No complex setup.
All 32 tools are live and waiting.
You're up and running in seconds.
Vinkius gives your AI agents access to the full catalog of app connectors, all fully managed, secure, and enterprise-ready. One subscription, every tool you need.
Built, hosted, and secured by Vinkius. You just connect and go.