Vinkius
USAspending (Federal Spending)

USAspending (Federal Spending) MCP for AI. Map money flow across agencies, states, and years.

Claude Claude
ChatGPT ChatGPT
Cursor Cursor
Gemini Gemini
Windsurf Windsurf
VS Code VS Code
JetBrains JetBrains
Vercel Vercel
See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

USAspending (Federal Spending) MCP on Cursor AI Code EditorUSAspending (Federal Spending) MCP on Claude Desktop AppUSAspending (Federal Spending) MCP on OpenAI Agents SDKUSAspending (Federal Spending) MCP on Visual Studio CodeUSAspending (Federal Spending) MCP on GitHub Copilot AI AgentUSAspending (Federal Spending) MCP on Google Gemini AIUSAspending (Federal Spending) MCP on Lovable AI DevelopmentUSAspending (Federal Spending) MCP on Mistral AI AgentsUSAspending (Federal Spending) MCP on Amazon AWS Bedrock

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.

+ 29 more capabilities included
Get Agency Budgetary Status

Retrieves an agency's total available budget and current obligation amounts across specified fiscal years.

Map Spending by Location

Filters and aggregates spending data based on specific states, counties, or congressional districts.

Track Specific Awards

Retrieves full details for a single federal award, including its funding source and associated sub-awards.

List Agency Components

Identifies all internal offices or sub-agencies within a department and reports their obligated spending amounts.

Bulk Export Data Sets

Generates ZIP files containing large data sets of awards, transactions, or subawards in CSV format for external analysis.

Analyze Disaster Funding

Provides dedicated insights into emergency and disaster-related spending across government agencies.

Included with Plan

Waiting for input…

AI Agent

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 Vinkius

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.

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.

Claude AI

Claude AI

1

Open Claude Settings

Go to claude.ai, click your profile icon, then navigate to Customize → Connectors.

2

Add Custom Connector

Click the "+" button and select Add custom connector. Paste your Vinkius endpoint URL:

https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp

Replace [YOUR_TOKEN_HERE] with your token from cloud.vinkius.com. For OAuth-protected servers, expand Advanced settings to add credentials.

3

Start a conversation

Open a new chat. The USAspending (Federal Spending) integration is available immediately — no restart needed.

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
Start building

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
USAspending (Federal Spending) MCP server cover

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

Your data is protected. See how we built it.

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.

Built · Hosted · Managed by Vinkius USAspending MCP Server - Analyze Federal Spending Data
Server ID 019e3904-54a9-7053-b48d-6ac7babd07f0
Vinkius Inspector
Compliance Grade A+
Score 98.33/100
Vinkius Inspector Badge — Score 98.33/100

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.

Built & Managed by Vinkius 30s setup 32 tools

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 runs on Claude Claude
Vinkius runs on ChatGPT ChatGPT
Vinkius runs on Cursor Cursor
Vinkius runs on Gemini Gemini
Vinkius runs on Windsurf Windsurf
Vinkius runs on VS Code VS Code
Vinkius runs on JetBrains JetBrains
Vinkius runs on Vercel Vercel
+ other MCP clients

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.

Zero hosting required Full MCP catalog included Enterprise-grade security Auto-updated by Vinkius

Built, hosted, and secured by Vinkius. You just connect and go.