# USAspending MCP for AI Agents AI Agent Connect > USAspending MCP for AI Agents. It connects your agent to the official federal spending database so you can query agency budgets, track specific contracts, and analyze where government money goes across different states and counties. No more manual searching through complex government tables. ## Overview - **Category:** industry-titans - **Price:** Free - **Endpoint:** https://edge.vinkius.com/vk_preview_SGqOxUwCS5vSVfgBiSV43hzg4gnIzYvjeGWqLvnr/ai-agent-connect - **Tags:** federal-spending, budget-analysis, transparency, financial-data, public-sector, award-tracking ## Description Connect to official government spending records and gain transparency into how the United States government allocates its budget. This Connector allows your AI agent to query real-time federal financial data, from high-level agency overviews to specific contract details. Imagine you need to track how much a specific federal agency spent on disaster relief last year. Instead of hunting through dozens of government pages and trying to piece together a spreadsheet, you just ask your AI client. It pulls that data directly from the source. You can get a high-level overview of an agency's budget or drill down into the specifics of a single contract. It handles the heavy lifting of navigating the official records, giving you a clear picture of federal obligations and outlays. Whether you're looking for geographic spending patterns or trying to find every award granted to a specific recipient, the data comes straight to your chat window. Because Vinkius hosts this Connector, you can plug it into your existing workflow and start auditing government spending in seconds without worrying about the technical setup. It turns a tedious research task into a quick conversation. You can see how money flows from the federal level down to specific counties or congressional districts, making it easier to spot trends or anomalies. It removes the friction of manual data entry and lets you focus on the actual analysis of public funds. ## Tools ### get_agency_budgetary_resources Lists budgetary resources and obligations for an agency by fiscal year. Use this to see how budgets change over time. ### get_subawards Lists all subawards linked to a specific parent award. This helps you see how funds are further distributed. ### get_agency_overview Retrieves the general overview page details for a specific agency. This provides a quick summary of an agency's profile. ### get_recipient Fetches individual details for a specific recipient. Use this to see exactly who received federal funds. ### autocomplete_glossary Suggests glossary terms that match your search text. This helps you find the right terminology for your query. ### autocomplete_location Suggests locations based on the text you enter. Use this to find the correct state or county for your geographic search. ### autocomplete_recipient Suggests recipient names and UEI numbers based on your search text. This helps you find the correct recipient for your data query. ### bulk_download_awards Creates a ZIP file containing award data in CSV format for local analysis. This is useful for moving large datasets into your own spreadsheets. ### download_search Downloads a ZIP file for Awards, Subawards, and Transactions based on your query. Use this to get a complete data dump for a specific search. ### get_agency_awards_count Provides the count of different award types for an agency during a specific fiscal year. This helps you quickly see the volume of awards. ### get_agency_awards Returns a summary of all transactions and obligations for a specific agency. It gives you a high-level view of an agency's activities. ### get_agency_sub_agencies Lists all sub-agencies and offices along with their obligated amounts. This helps you see the internal distribution of spending. ### get_award_funding Shows the federal account and agency funding details for a specific award. This clarifies which part of the budget funded a specific contract. ### get_award Pulls the full details for a specific federal award. Use this to get every detail about a single contract or grant. ### get_award_types Provides a map of award types grouped by category. This helps you understand how the government classifies different types of funding. ### get_data_dictionary Returns the JSON structure for the Rosetta Crosswalk Data Dictionary. This is helpful for understanding the underlying data fields. ### get_disaster_agency_spending Shows which agencies received funding specifically for disaster relief. Use this to track emergency fund distribution. ### get_disaster_award_amount Aggregates obligations and outlays for disaster-related awards. This gives you a total picture of disaster spending. ### get_disaster_overview Provides a summary of disaster and emergency funding and spending. This is great for high-level disaster relief analysis. ### get_download_status Checks the current progress of a requested data download job. Use this to see if your bulk data request is finished. ### get_glossary Lists all glossary terms and definitions used in the database. This helps you understand the specific terminology of federal spending. ### get_recipient_children Retrieves details for recipients based on a specific identifier. Use this to find related entities in the spending chain. ### get_recipient_state Provides basic information about a specified state's spending. This helps ground your spending data in a geographic context. ### get_toptier_agencies Lists all toptier agencies and their relevant data points. This is a good starting point for broad agency research. ### get_transactions Lists all transactions associated with a specific parent award. Use this to see the actual flow of money for a specific contract. ### list_recipients Lists all recipients currently in the database. This allows you to see the full scope of entities receiving federal funds. ### search_new_awards_over_time Lists the specific time periods where new awards were issued. Use this to see when the government started awarding new contracts. ### search_spending_by_award Filters and searches for awards based on specific spending criteria. This helps you narrow down results to exactly what you need. ### search_spending_by_category Groups spending data by agency, recipient, or CFDA for visualization. This is perfect for creating charts of spending types. ### search_spending_by_geography Finds spending data filtered by state, county, or congressional district. Use this to see how money is distributed across the country. ### search_spending_over_time Aggregates transaction amounts across different time periods. This helps you see if spending is increasing or decreasing. ### autocomplete_awarding_agency Suggests awarding agencies that match your search text. Use this to find the exact name of the agency you are looking for. ## Prompt Examples **Prompt:** ``` How much did the Department of Justice spend on awards in 2023? ``` **Response:** ``` For fiscal year 2023, the Department of Justice (015) had the following award activity: | Award Type | Total Amount | | :--- | :--- | | Contracts | $X.X Billion | | Grants | $Y.Y Billion | They focused heavily on [Category] with total obligations of $Z billion. Would you like a breakdown of specific contracts? ``` **Prompt:** ``` List the sub-agencies for the Dept of Energy and tell me how much they spent. ``` **Response:** ``` The Department of Energy (089) has several sub-agencies. For example, the [Office Name] obligated $A, while the [Office Name] obligated $B. Would you like a full breakdown of all offices and their obligated amounts? ``` **Prompt:** ``` Find all federal spending in the state of Florida for last year. ``` **Response:** ``` In fiscal year 2023, federal spending in Florida was distributed across various counties. * **Harris County** received the highest amount at $C * **Dallas County** followed at $D Most of this spending was categorized under 'Contracts'. Would you like to see a breakdown by county? ``` ## Capabilities ### Pull agency budget overviews Get high-level summaries of federal agency budgetary resources and obligations. ### Track specific federal awards Search for and filter through millions of federal awards, contracts, and grants. ### Map spending by state or county Break down federal spending by geography to see exactly where the money is going. ### Break down sub-agency spending Identify the internal spending distribution of specific offices and sub-agencies. ### Analyze spending trends over time Identify fiscal patterns by reviewing award counts and spending over different periods. ### Identify disaster-specific funding Get insights on agencies receiving funding for disasters and emergency spending. ### Download bulk award data Generate ZIP files containing award data in CSV format for your own analysis. ## Use Cases ### Investigative Reporting A journalist wants to see all contracts in a specific county. They use `search_spending_by_geography` to find high-value awards in a specific district. ### Policy Auditing A researcher needs to know how much the Dept. of Energy spent on specific programs. They use `get_agency_budgetary_resources` to get a year-by-year breakdown. ### Disaster Analysis A non-profit wants to see how much federal money went to local agencies during a hurricane. They use `get_disaster_agency_spending` to get the totals. ### Data Export A data scientist needs a full list of awards for a specific category. They use `bulk_download_awards` to get a ZIP file for their own dashboard. ## Benefits - Skip the manual search for federal contracts by using `get_award` to pull specific data instantly into your chat. - Identify geographic spending gaps quickly with `search_spending_by_geography` to see exactly where money lands in your state. - Analyze disaster relief efforts with `get_disaster_overview` to see how emergency funds are being distributed across agencies. - Export large datasets for external reports by using `bulk_download_awards` to get CSV files for your own spreadsheets. - Map out internal agency structures and spending with `get_agency_sub_agencies` to see who is actually managing the funds. - Track fiscal patterns over years using `search_spending_over_time` to see how budgets change across different fiscal cycles. ## How It Works The bottom line is you get direct access to federal financial records without having to navigate the government website yourself. 1. Subscribe to the USAspending MCP on Vinkius. 2. Enter your USAspending API Key to establish the connection. 3. Ask your AI client to find specific spending data or download reports. ## Frequently Asked Questions **Can I use the USAspending MCP to find specific government contracts?** Yes, you can. The Connector lets your agent search for specific awards, including contract details, funding amounts, and the recipients involved. **How do I find out which agencies got disaster relief money?** You can ask the USAspending MCP to show you disaster-specific spending. It will pull data on which agencies received funding for emergency and disaster relief. **Can I download the data to my own computer?** Yes, the Connector includes tools to generate ZIP files of award data in CSV format. This makes it easy to move the data into your own spreadsheets or analysis tools. **Can I see spending by county or congressional district?** Yes, you can search for spending by geography. The Connector can break down federal spending by state, county, or congressional district. **Is this for looking up private company spending?** No, this Connector is specifically for US federal spending. It connects to the official USAspending database to show how the government allocates its budget. **Can I see how much a specific agency spent over several years?** Yes, you can use the Connector to analyze spending and new award counts over time. It helps you identify fiscal patterns and budget changes across different years. **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.