U.S. Treasury Full MCP. Track every dollar of U.S. government finance.
Works with every AI agent you already use
…and any MCP-compatible client
Just plug in your AI agents and start using Vinkius.
U.S. Treasury Full provides deep access to the entire financial reporting mechanism of the U.S. federal government. Use 13 tools to track national debt, analyze daily cash flow, model budget deficits/surpluses, and monitor interest rates.
Get real-time data on spending, revenue, and global exchange rates—all without managing API keys or signing up for external accounts.
What your AI agents can do
Get avg interest rates
Retrieves the average interest rates paid on U.S. Treasury securities, updated monthly.
Get daily cash balance
Fetches the current daily operating cash balance of the U.S. Treasury—the government's bank statement.
Get daily debt transactions
Gets a record of public debt transactions, showing issuance and redemptions for today or year-to-date.
Track how national debt changes over time, distinguishing between public holdings and internal government funds using get_public_debt_breakdown.
Compare the federal budget's current revenue against spending totals to calculate the deficit or surplus for a given fiscal period (using get_federal_revenue and get_deficit_surplus).
Get the government’s daily cash balance (get_daily_cash_balance) and monitor recent debt transactions, which shows how the U.S. moves money on a day-to-day basis.
Determine the average interest rates paid by the federal government, reflecting its current cost of borrowing from markets (get_avg_interest_rates).
Get official Treasury exchange rates for over 170 currencies or check historical rate fluctuations between two specific countries.
Ask AI about this MCP
Supported MCP Clients
Waiting for input…
U.S. Treasury Full — Complete Fiscal & Debt Intelligence (13 Tools)
Access all 13 tools to query U.S. financial data: debt history, cash balances, budget surpluses, interest rates, and global exchange rates.
019d7615get avg interest rates
Retrieves the average interest rates paid on U.S. Treasury securities, updated monthly.
019d7615get daily cash balance
Fetches the current daily operating cash balance of the U.S. Treasury—the government's bank statement.
019d7615get daily debt transactions
Gets a record of public debt transactions, showing issuance and redemptions for today or year-to-date.
019d7615get debt history
Retrieves the total national debt amount for any specified date range (YYYY-MM-DD).
019d7615get deficit surplus
Provides the federal budget deficit or surplus calculation, tracking figures year-to-date.
019d7615get exchange rate for currency
Gets historical Treasury exchange rates for a specific foreign currency (e.g., Euro or Pound).
019d7615get federal revenue
Shows the federal government's tax receipts, detailing both current month and fiscal-year totals.
019d7615get federal spending
Retrieves total federal spending by department and agency, comparing current monthly outlays to prior years.
019d7615get national debt
Gives the U.S. national debt (Total Public Debt Outstanding) updated daily down to the penny.
019d7615get public debt breakdown
Provides a statement of public debt breakdown, separating market-held securities from internal government funds.
019d7615get treasury auctions
Gets results from recent Treasury auctions for Bills, Notes, and Bonds, including investor demand ratios.
019d7615get treasury exchange rates
Provides the official quarterly exchange rates for 170+ currencies against the U.S. dollar.
019d7615query treasury dataset
Allows querying any specific fiscal data dataset on treasury.gov by providing the exact API endpoint path.
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 U.S. Treasury Full — Complete Fiscal & Debt Intelligence, then connect any of our 4,700+ other servers whenever your AI needs more. One click, no limits.
- Use this MCP plus 4,700+ 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
What you can do with this MCP connector
Look, if you're dealing with federal finances—the big picture stuff—you need the U.S. Treasury Full MCP. This isn't some watered-down data feed; it gives you deep access to the entire financial reporting mechanism of the government. You won't waste time managing API keys or signing up for outside accounts, either.
Here’s what this setup lets you do:
Tracking National Debt and Public Holdings:
You can get the total U.S. national debt—the Total Public Debt Outstanding—updated daily down to the penny using get_national_debt. To really understand where that money's sitting, use get_public_debt_breakdown for a statement separating market-held securities from internal government funds; it’ll show you exactly what you’re dealing with.
You can track how the whole debt picture changes over time by running get_debt_history against any specific date range (YYYY-MM-DD). For day-to-day movements, you get a record of public debt transactions—showing issuance and redemptions for either today or year-to-date—via get_daily_debt_transactions. You can also monitor the results from recent Treasury auctions for Bills, Notes, and Bonds, including key investor demand ratios, by running get_treasury_auctions.
Analyzing Cash Flow Against Budgetary Pressures:
To see if the government's spending keeps up with its income, you check two things. First, you pull total federal spending from every department and agency using get_federal_spending, which compares current monthly outlays against prior years. Second, you get the federal government's tax receipts—details on both the current month and fiscal-year totals—using get_federal_revenue.
You can then determine the full federal budget deficit or surplus calculation by running get_deficit_surplus, tracking figures year-to-date. For a look at liquidity, you pull the government’s daily operating cash balance using get_daily_cash_balance, which is basically their bank statement. You also get the average interest rates paid on U.S. Treasury securities updated monthly by calling get_avg_interest_rates.
Global and Fiscal Rate Intelligence:
If you're thinking international, this server’s got your back. You can pull official quarterly exchange rates for over 170 currencies against the U.S. dollar using get_treasury_exchange_rates. If you need to check a specific historical rate between two countries—say, the Euro or the Pound—you use get_exchange_rate_for_currency to get that history.
You can also pull official treasury exchange rates for any foreign currency, not just those 170+. For deep dives into fiscal data beyond these tools, you've got query_treasury_dataset, which lets your AI client query any specific dataset on treasury.gov just by giving it the exact API endpoint path.
This setup gives you total control over tracking national debt trajectories and monitoring how money moves day-to-day across every major sector of the federal government.
How U.S. Treasury Full MCP Works
- 1 You ask your AI client to assess a fiscal question (e.g., 'What was the deficit last quarter?')
- 2 The agent identifies the necessary tools, calling functions like
get_deficit_surplusandget_federal_spendingin sequence. - 3 It compiles the returned data points—the current debt level, historical rates, and spending figures—into a cohesive answer for you.
The bottom line is: your AI client acts as the analyst, pulling specific metrics from multiple Treasury endpoints to build an answer where you just asked a question.
Who Is U.S. Treasury Full MCP For?
This server is for financial analysts and economic strategists who need to stitch together disparate pieces of federal data—debt levels, revenue streams, and interest rates—into one cohesive picture. It’s for the portfolio manager tired of jumping between three different government APIs just to build a basic model.
Uses get_deficit_surplus and get_federal_spending to draft reports on fiscal responsibility, needing clear month-over-month comparisons.
Relies heavily on get_national_debt, get_public_debt_breakdown, and get_treasury_auctions to gauge market demand and overall risk exposure.
Uses the currency tools (get_treasury_exchange_rates) alongside budget data to model cross-border spending impacts.
What Changes When You Connect
- See the full picture by correlating cash flow and debt: Use
get_daily_cash_balancealongsideget_national_debtto understand immediate liquidity versus total outstanding liability. - Model fiscal performance year-to-date: The agent pulls data from
get_federal_revenueand compares it againstget_federal_spendingto isolate the running deficit or surplus usingget_deficit_surplus. - Track global impact instantly: Use
get_treasury_exchange_ratesto pull official rates for 170+ currencies, letting you model foreign exchange impacts on spending reports. - Understand debt composition: Don't just look at the total. Call
get_public_debt_breakdownto differentiate between money held by the public and internal government trust funds. - Monitor market demand: Review recent auction results using
get_treasury_auctions. This shows if investor appetite for U.S. debt is strong or weak.
Real-World Use Cases
Assessing immediate solvency
A hedge fund manager needs to know if the government has enough cash reserves right now. They ask their agent: 'What's the current cash balance and how did debt transactions affect it today?' The agent runs get_daily_cash_balance and get_daily_debt_transactions, giving them a real-time picture of immediate solvency.
Building a long-term fiscal projection
An economic advisor needs to project debt growth over the next two decades. They ask for the national debt history and current interest costs. The agent combines get_debt_history with get_avg_interest_rates, giving them both past trends and future cost inputs.
Analyzing budget performance against forecasts
A policy advisor is writing a report on spending priorities. They need to show how department outlays compare year-over-year. The agent uses get_federal_spending and compares it with the corresponding data from get_federal_revenue, allowing the advisor to point directly to structural deficits.
Modeling multi-currency investments
A multinational firm needs to know how a shift in local currency affects their U.S.-denominated debt servicing costs. They ask for historical rates, and the agent uses get_exchange_rate_for_currency to build an accurate conversion model.
The Tradeoffs
Using only general search
Searching Google for 'US national debt' gets a single number, but doesn't show if that figure includes internal holdings or how the daily cash balance has moved.
→
You must use get_national_debt and immediately follow up with get_public_debt_breakdown. This gives you the full picture: total owed vs. who owns it.
Guessing the API endpoint
Trying to build a custom query without knowing the exact dataset path on treasury.gov.
→
If all else fails, use the powerful query_treasury_dataset tool. Just provide the specific API path you need; it bypasses the structured tools.
Ignoring historical context
Just looking at today's deficit number and thinking that's all there is to it.
→
Always contextualize the data by running get_debt_history alongside get_deficit_surplus. This shows if the current numbers are an outlier or part of a continuing trend.
When It Fits, When It Doesn't
Use this server if your task requires stitching together metrics from multiple, distinct U.S. financial data sources (e.g., linking spending to debt, or currency rates to deficits). You need the depth that only direct government API access provides.
Don't use it if: 1) you just need a general news summary about US debt (use search instead); 2) your analysis is limited to one single metric (e.g., just checking today's cash balance—a simple query works fine). If you only care about the current state of the economy and not the underlying mechanics, this is overkill.
When in doubt: Always run a sequence of tools. For example, if analyzing fiscal health, combine get_national_debt (the scale) with get_deficit_surplus (the trend) to get actionable intelligence.
Independent Platform Disclaimer: Vinkius is an independent platform and is not affiliated with, endorsed by, sponsored by, verified by, or otherwise authorized by U.S. Department of the Treasury. 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 server provides 13 capabilities that interface natively with Claude, ChatGPT, Cursor, and any MCP client. No middleware. No custom integration required.
Available Capabilities
Analyzing US Fiscal Health Shouldn't Require Three Different Dashboards.
Right now, getting a complete picture of the U.S. fiscal state means manually logging into Treasury websites. You grab the national debt from one page, check cash flow on another, and calculate the budget deficit using a third dashboard. Then you spend an hour copy-pasting numbers and cross-referencing dates just to get a simple summary.
With this MCP Server, you prompt your agent once: 'Summarize the current fiscal state.' The system automatically runs `get_national_debt`, checks `get_daily_cash_balance`, and pulls the latest deficit figure via `get_deficit_surplus`. You get the final analysis—not just a pile of raw numbers.
The U.S. Treasury Full MCP Server: Accessing Deep Financial Intelligence
You no longer have to guess which API endpoint holds the answer for foreign exchange or auction results. The server exposes specific tools like `get_treasury_exchange_rates` and `get_treasury_auctions`, meaning you just name the data point, and it appears.
This isn't just a collection of APIs; it's a unified financial intelligence layer. Your AI client pulls complex economic metrics—like the difference between Debt Held by the Public and Intragovernmental Holdings—and delivers them to you in plain English.
Common Questions About U.S. Treasury Full MCP
How do I check the total national debt using get_national_debt? +
You just ask for it. The tool provides the U.S. Total Public Debt Outstanding, updated daily and broken down by key components like public holdings.
What is the difference between getting a deficit using get_deficit_surplus versus looking at revenue and spending? +
While get_federal_revenue and get_federal_spending show the gross inputs, get_deficit_surplus calculates the net result (the actual gap or surplus) for you year-to-date.
Can I track how debt changes over time with get_debt_history? +
Yes. You provide a date range (e.g., 2018-01-01 to 2023-12-31), and the tool returns the national debt totals for that period, letting you plot historical growth.
How do I see what the Treasury is buying or selling? +
Use get_treasury_auctions. This tool gives you the latest results from sales of Bills, Notes, and Bonds, along with metrics like the bid-to-cover ratio to gauge demand.
Does the U.S. Treasury Full Server require an API key when running tools like get_national_debt? +
No, it doesn't. The server operates with zero authentication for all 13 tools. This means your AI agent connects directly without needing to manage or input any credentials, which significantly simplifies the setup.
When I use get_public_debt_breakdown, what is the difference between 'Debt Held by the Public' and 'Intragovernmental Holdings'? +
The breakdown separates two distinct debt categories. 'Public' represents marketable securities bought from external investors (like pension funds). 'Intragovernmental' covers internal trust funds, such as Social Security holdings.
How frequently are the currency rates updated when I call get_treasury_exchange_rates? +
The official Treasury exchange rates update quarterly. While this provides a standardized rate across 170+ currencies for government reporting, it is important to know these aren't real-time market feeds.
What does the output from get_daily_cash_balance represent compared to the total national debt? +
The cash balance reports the Treasury's actual daily bank liquidity—the physical funds on hand. This metric is separate from the total national debt, which measures all outstanding liabilities owed by the government.
Why build a mega server? +
Because an AI agent performs better when all context is centralized. By combining Debt, FX and Budget into one tool suite, the prompt routing evaluates economic dependencies efficiently.
Is there an API Rate Limit? +
No official API key is required, however they rate limit by IP if abused. This server utilizes graceful error handling.
Are these figures inflation adjusted? +
Values are nominal as recorded by accounting ledgers. The AI agent must query CPI (Consumer Price Index) if adjustment is required.
Use it with your favorite AI tools
Connect this server to Cursor, Claude, VS Code, and more.
More in this category
arXiv
Search 2.5M+ scientific preprints across physics, computer science, mathematics, biology, economics, and more — with full abstracts, author lists, and direct PDF download links.
GridStatus
Access real-time and historical US electricity grid data — load, fuel mix, LMP pricing, and generation across all major ISOs (ERCOT, CAISO, PJM, MISO, NYISO, ISO-NE, SPP).
PubMed
Search 37M+ biomedical research articles from the world's largest medical literature database — with full abstracts, authors, MeSH terms, and citation tracking.
You might also like
GoHighLevel Alternative
Manage your GHL location — audit contacts, opportunities, and tasks via AI.
Email (.eml) File Parser
Transform heavy raw email exports into crystal-clear text local. Let your AI act as your personal secretary, instantly summarizing threads without wasting context window tokens.
Oxylabs SERP
Extract structured search engine results via Oxylabs — scrape Google, Bing, Yandex, Baidu, and YouTube rankings directly from your AI agent.