# U.S. Treasury Full MCP

> U.S. Treasury Full — Complete Fiscal & Debt Intelligence provides immediate access to core U.S. federal financial data. Get daily national debt figures, analyze budget deficits and surpluses, check current cash balances, and track official foreign exchange rates—all without needing API keys or complex setup. It's the definitive feed on how the U.S. government finances itself.

## Overview
- **Category:** the-unthinkable
- **Price:** Free
- **Tags:** fiscal-data, national-debt, federal-budget, exchange-rates, economic-reporting, public-finance

## Description

This MCP gives you a direct line to the financial pulse of the U.S. government. You can pull detailed data on national debt, tracking everything from total public outstanding debt to specific breakdowns like intragovernmental holdings. Need to know if the budget is running a deficit or surplus? This tool provides year-to-date figures for both revenue and spending. It also keeps tabs on the Treasury's daily cash balance and how much money they have on hand. Furthermore, you can analyze global finance by pulling official exchange rates for over 170 currencies against the dollar. Whether you're checking historical debt trends or need today’s operational outlays, this entire catalog of data is available through Vinkius, connecting directly to the U.S. Department of the Treasury.

## Tools

### get_federal_revenue
Retrieves current month and fiscal-year-to-date totals for federal government tax receipts by source, compared to the previous year.

### get_federal_spending
Gets total federal spending by department and agency, showing current month gross outlays versus prior year figures.

### get_deficit_surplus
Calculates the U.S. federal budget deficit or surplus using fiscal year-to-date accounting data (October 1 through September 30).

### get_daily_cash_balance
Provides the daily operating cash balance of the U.S. Treasury, showing how much liquid cash is currently available.

### get_daily_debt_transactions
Shows day-by-day public debt transactions, detailing amounts for both new issuances and redemptions month-to-date or year-to-date.

### get_national_debt
Pulls the total U.S. national debt (Total Public Debt Outstanding) to the penny, breaking it down into public and intragovernmental holdings.

### get_debt_history
Provides historical national debt figures for a specific date range you define, useful for tracking economic cycles.

### get_public_debt_breakdown
Generates the Statement of Public Debt, separating and detailing holdings by both public investors and internal government trust funds.

### get_avg_interest_rates
Returns average interest rates on U.S. Treasury securities, indicating the cost of borrowing for the federal government.

### get_treasury_auctions
Gathers results from recent Treasury securities auctions (Bills, Notes, Bonds) and assesses investor demand via the bid-to-cover ratio.

### get_treasury_exchange_rates
Gets official quarterly exchange rates for over 170 currencies against the U.S. dollar, used for government reporting.

### get_exchange_rate_for_currency
Retrieves historical Treasury exchange rate data for a specific currency like the Euro or British Pound.

### query_treasury_dataset
Allows you to query any specified fiscal dataset endpoint path on treasury.gov, providing maximum flexibility in analysis.

## Prompt Examples

**Prompt:** 
```
Give me a complete summary of the U.S. fiscal state: current debt, latest deficit, and cash balance.
```

**Response:** 
```
📊 **U.S. Treasury: Fiscal State Overview**

- National Debt: $34,812,456,789.12
- Fiscal Year Deficit to Date: $845,000,000,000
- Current Treasury Cash Balance: $825,443,000,000
```

**Prompt:** 
```
Extract federal spending vs federal revenue for the last 6 months
```

**Response:** 
```
📊 **U.S. Federal Revenues vs. Outlays (6 Months)**

- Mar 2026: Revenue $354B | Outlays $492B | Deficit $138B
- Feb 2026: Revenue $271B | Outlays $567B | Deficit $296B
- Jan 2026: Revenue $477B | Outlays $455B | Surplus $22B
```

**Prompt:** 
```
Show historic exchange rates for USD -> GBP to analyze currency fluctuations
```

**Response:** 
```
📊 **Historical Rates: UK (Pound Sterling)**

- Mar 2026: 0.79 GBP per 1 USD
- Dec 2025: 0.78 GBP per 1 USD
- Sep 2025: 0.82 GBP per 1 USD
```

## Capabilities

### Track national financial obligations
Get the current total public outstanding debt and track its historical growth over specific dates.

### Analyze federal budget performance
Determine if the U.S. government is running a deficit or surplus by comparing spending, revenue, and internal cash balances.

### Model foreign exchange fluctuations
Retrieve official Treasury exchange rates for specific countries or view historical rate changes across multiple currencies.

### View daily financial transactions
See the day-by-day mechanics of U.S. public debt, showing both issuance and redemptions.

## Use Cases

### Determining budget stability after a major spending bill
A policy advisor needs to know the immediate impact of new legislation. They ask their agent for a summary using `get_deficit_surplus`, then follow up by checking `get_daily_cash_balance` to see if the Treasury has enough liquid funds right now.

### Comparing market demand against historical debt levels
A financial researcher wants to prove that investor confidence is strong. They use `get_treasury_auctions` for recent bid-to-cover ratios and then run `get_national_debt` alongside it to show the scale of the required borrowing.

### Tracking currency shifts for international trade models
A supply chain manager needs to model costs involving European partners. They use `get_exchange_rate_for_currency` (e.g., 'Euro') to get historical rates, then integrate that data into a spending forecast.

### Performing an end-to-end fiscal status report
An economic analyst wants one comprehensive view. They ask for the current debt (`get_national_debt`), the latest budget deficit (`get_deficit_surplus`), and recent federal spending figures using `get_federal_spending`.

## Benefits

- You stop relying on generalized economic reports. With this MCP, you pull direct figures for things like national debt using `get_national_debt`, giving your analysis verifiable numbers right now.
- Comparing annual spending versus revenue is simple. You use the `get_federal_spending` and `get_federal_revenue` tools to see month-to-month outlays, making budget tracking instant.
- Forget manually checking cash balances across different government sites. The `get_daily_cash_balance` tool gives you the single, current operational bank statement for the U.S. Treasury.
- Analyzing global finance is straightforward. Instead of searching through scattered rate tables, use `get_treasury_exchange_rates` to get official data for 170+ currencies in one query.
- You can map out debt evolution over decades. The `get_debt_history` tool lets you track national debt growth across specific timeframes like election cycles or economic crises.

## How It Works

The bottom line is you get authoritative financial metrics from the source without having to write complex API calls yourself.

1. Specify what financial data you need—for example, 'the total national debt for 2010' or 'revenue for the last quarter'.
2. Your AI client uses this MCP to query the specific Treasury dataset that holds that information.
3. You receive clean, structured data showing the requested figures (like cash balances or deficits) directly in your chat window.

## Frequently Asked Questions

**How often is the national debt updated with U.S. Treasury Full — Complete Fiscal & Debt Intelligence?**
The national debt figures are updated daily by the Treasury Department. This MCP ensures you get the most current total public outstanding debt available.

**Can I compare spending and revenue over multiple years using U.S. Treasury Full — Complete Fiscal & Debt Intelligence?**
Yes, you can analyze historical trends by running `get_federal_revenue` and `get_federal_spending` for different fiscal periods to spot growth patterns.

**What kind of currencies does U.S. Treasury Full — Complete Fiscal & Debt Intelligence cover?**
It covers official exchange rates for over 170 currencies against the U.S. dollar, ensuring you use government-reported figures.

**Is this MCP only for macroeconomics? Can I get specific debt details?**
No, it's detailed enough for granular analysis. You can run `get_public_debt_breakdown` to see exactly how the total public debt is structured.

**How do I check historical rates using U.S. Treasury Full — Complete Fiscal & Debt Intelligence?**
Use `get_exchange_rate_for_currency`, providing the specific currency and date range, to track how a rate changed over time.