# Treasury Budget MCP

> U.S. Treasury Budget Server provides immediate access to the federal government's full financial picture. Track daily cash balances, monitor debt issuance and redemptions, calculate deficits or surpluses for any fiscal year, and get detailed reports on both tax revenue sources and departmental spending expenditures.

## Overview
- **Category:** industry-titans
- **Price:** Free
- **Tags:** federal-budget, fiscal-data, public-spending, economic-reporting, revenue-tracking, government-finance

## Description

**`get_daily_cash_balance`**: It gives you the current operating cash balance for the entire U.S. Treasury, so you know exactly how much liquid cash is available right now.

**`get_daily_debt_transactions`**: You'll see the daily mechanics of federal debt movements here; it tracks both new bond issuance and scheduled redemptions (the payments they gotta make).

**`get_federal_revenue`**: This tool determines where the government’s money comes from, listing all the tax receipts grouped by source. It lets you compare current tax periods directly to prior years.

**`get_federal_spending`**: You can review federal spending amounts broken down by every department and agency. The report includes year-over-year comparisons so you know how expenditures stack up against previous cycles.

**`get_deficit_surplus`**: Use this to calculate the total federal budget deficit or surplus for a specified fiscal year period, using Oct 1 through Sep 30 as your timeframe.

## Tools

### get_federal_revenue
Gets total government tax revenue, showing sources and comparing current periods to prior years.

### get_federal_spending
Retrieves federal spending amounts, broken down by department and agency, with year-over-year comparisons.

### get_deficit_surplus
Calculates the federal budget deficit or surplus for a specified fiscal year period.

### get_daily_cash_balance
Gets the current operating cash balance for the entire U.S. Treasury, showing how much cash is immediately available.

### get_daily_debt_transactions
Retrieves daily public debt movements, detailing both new bond issuance and scheduled redemptions (payments).

## Prompt Examples

**Prompt:** 
```
What is the current U.S. budget deficit?
```

**Response:** 
```
📊 **U.S. Federal Deficit**

For Fiscal Year 2025:
Total Deficit: $1,695,432,100,000
This represents the gap between $4.8T in revenue and $6.5T in outlays.
```

**Prompt:** 
```
How much did the U.S. government collect in revenue last month?
```

**Response:** 
```
📊 **Federal Revenue**

Total collections (March 2026): $354,112,000,000
Top Sources:
1. Individual Income Taxes: $192B
2. Social Insurance Taxes: $124B
3. Corporate Income Taxes: $22B
```

**Prompt:** 
```
What is the daily Treasury cash balance?
```

**Response:** 
```
📊 **Daily Treasury Statement**

Operating Cash Balance as of 2026-04-01:
- Total Balance: $825,443,000,000
- Federal Reserve Account: $820,111,000,000
- Tax and Loan Accounts: $5,332,000,000
```

## Capabilities

### Calculate Fiscal Deficits
Pinpoint the total federal budget deficit or surplus for a specific fiscal year using `get_deficit_surplus`.

### Track Treasury Liquidity
Get an immediate snapshot of the U.S. government's current operating cash balance via `get_daily_cash_balance`.

### Analyze Revenue Sources
Determine exactly where federal money comes from by listing tax receipts grouped by source using `get_federal_revenue`.

### Monitor Spending Details
Review government expenditures, broken down by department and agency, with comparisons against previous years using `get_federal_spending`.

### Map Debt Activity
See the daily mechanics of federal debt—how much is issued and how much is retired through `get_daily_debt_transactions`.

## Use Cases

### Assessing Funding Stability
A policy researcher needs to know if current spending levels are sustainable. They ask the agent: 'Compare `get_federal_spending` trends with `get_federal_revenue`. What does this tell us about the long-term viability?' The agent runs both tools, highlights the mismatch in growth rates, and calculates a preliminary deficit using `get_deficit_surplus`.

### Investigating Cash Flow Volatility
An analyst notices spending spikes but can't track the real-time cash impact. They prompt: 'What is our current liquidity, and how are we financing it?' The agent pulls `get_daily_cash_balance` for an immediate view and cross-references that with recent debt activity from `get_daily_debt_transactions`.

### Auditing Tax Source Shifts
A consultant wants to know if revenue is becoming too reliant on one source. They run `get_federal_revenue` for the last two quarters, getting a clean breakdown of individual vs. corporate tax receipts. This allows them to advise on structural diversification.

### Modeling Budget Impact
A student wants to understand macroeconomics by comparing budgets. They instruct their agent: 'Show me the total deficit using `get_deficit_surplus`, and then show me what the top three spending departments are doing this month via `get_federal_spending`.' The system provides a clear, comparative view.

## Benefits

- See the total fiscal gap instantly. Instead of manually comparing spreadsheets, use `get_deficit_surplus` to calculate the running deficit or surplus for any period.
- Understand daily liquidity without logging into five different government sites. `get_daily_cash_balance` gives you the single operating cash figure for the Treasury.
- Pinpoint where tax money comes from. `get_federal_revenue` breaks down income by source—you can tell if individual taxes or corporate fees are driving revenue growth.
- Compare spending year over year in one prompt. `get_federal_spending` shows gross outlays per department, making it easy to spot spikes in expenditure compared to the previous cycle.
- Map the debt mechanics automatically. Use `get_daily_debt_transactions` to track exactly when bonds are issued or paid back, which is critical for predicting cash flow changes.

## How It Works

The bottom line is, your agent handles all the complex data retrieval and synthesis across multiple sources so you get one clean answer.

1. You prompt your agent with a specific financial question, for example: 'What was the total revenue last month?'
2. Your AI client calls `get_federal_revenue`, which pulls and processes the raw tax receipt data from the Treasury API.
3. The agent formats the results—showing you the total collections and key source breakdowns (e.g., individual vs. corporate)—and gives you a clear answer.

## Frequently Asked Questions

**How do I find out the total government income using `get_federal_revenue`?**
You run `get_federal_revenue`. The tool returns a breakdown of tax receipts grouped by source (like individual vs. corporate) and shows both the current month's total and how that compares to last year.

**What does `get_daily_cash_balance` actually report?**
`get_daily_cash_balance` gives you the operating cash balance of the U.S. Treasury—basically, the amount of cash the government has on hand right now.

**Can I track changes in debt using `get_daily_debt_transactions`?**
Yes, that’s exactly what it does. It shows daily public debt transactions, which means you see both new bond issuance and scheduled redemptions (payments).

**How do I calculate the budget deficit for a specific year? Use `get_deficit_surplus`.**
To run it, you specify the fiscal period. The tool calculates the federal budget deficit or surplus up to that date using your parameters.

**Does `get_federal_spending` include all departments?**
Yes. It gets federal spending amounts by department and agency, providing a detailed breakdown of where government money is going month over month.

**When calling `get_federal_revenue`, do I need to manage credentials or API keys?**
No, you don't. The server operates with zero authorization requirements, meaning you connect and start using the tool immediately across all your preferred AI clients.

**How current is the data provided by `get_daily_cash_balance`?**
The balance reflects the official closing cash position. Data updates are typically delayed until the end of the federal business day, so expect daily figures to lag slightly.

**If I run multiple checks, like `get_federal_spending` and `get_deficit_surplus`, do those calls have rate limits?**
There are no published hard rate limits for the server. However, running excessive queries in rapid succession might temporarily throttle your connection. Keep your requests structured.

**What is the Daily Treasury Statement?**
It acts as the U.S. government's daily checking account statement, showing cash deposits and withdrawals.

**When does the fiscal year start?**
The U.S. government fiscal year begins on October 1 and ends on September 30.

**Is defense spending tracked here?**
Yes, the Monthly Treasury Statement provides outlays by agency, including the Department of Defense.