# U.S. Treasury Debt MCP > U.S. Treasury Debt — National Debt & Interest Rates provides real-time access to federal borrowing data. Use it to get the total U.S. national debt to the penny, monitor current average interest rates on Treasury securities, and check the results of recent Treasury auctions. It's your single source for tracking how much the government owes and what it costs to pay that debt. ## Overview - **Category:** the-unthinkable - **Price:** Free - **Tags:** national-debt, interest-rates, treasury-bonds, fiscal-policy, economic-indicators, public-debt ## Description Look, you gotta know what's going on with federal money, plain and simple. This MCP Server gives your AI client straight access to U.S. Treasury data. It’s where you go when you need hard numbers on national debt, interest rates, or how the government is actually borrowing cash. Need to track the total amount of debt? You can use `get_national_debt` right away; it spits out the current U.S. national debt down to the penny. That figure’s broken down for you—you see exactly what's public holdings versus intragovernmental stuff. To really drill down into how that money is structured, hit up `get_public_debt_breakdown`. This tool separates out the funds held by the open market from internal government accounts. It gives you a precise read on the components making up that debt total. If tracking today's figure isn't enough, you can run historical analysis with `get_debt_history`. Just give it a specific date range—like tracking growth across two election cycles or fiscal years—and it pulls those numbers for you. You don't have to pull reports from five different sources; this keeps your records straight. For the cost of servicing that debt, you gotta check interest rates. `get_avg_interest_rates` gives you the average rate on U.S. Treasury securities. Since this data updates monthly, it shows you the current price tag for the federal government's borrowing, telling you how much they're paying to keep the lights on. And when the government goes shopping for cash—the auctions—you can use `get_treasury_auctions`. This tool retrieves the results for recent sales of Bills, Notes, and Bonds. It doesn't just give you a list; it includes metrics like the bid-to-cover ratio. That number is key because it tells your agent how much investors are actually willing to pay, giving you an immediate gauge of market demand. Your AI client handles all this stuff in one place. You get instant visibility into the total outstanding debt via `get_national_debt`, analyze historical trends using `get_debt_history`, and calculate current borrowing costs with `get_avg_interest_rates`. The system also lets you view a precise breakdown of public debt components through `get_public_debt_breakdown` and measure real-time market appetite by accessing auction results via `get_treasury_auctions`. You're tracking the whole story: what they owe, how much it cost to borrow, and who’s buying the bonds. ## Tools ### get_national_debt Provides the current U.S. national debt to the penny, broken down into public and intragovernmental holdings. ### get_debt_history Retrieves the national debt total for a specific date range you provide. ### get_public_debt_breakdown Shows the detailed statement of public debt, separating funds held by the public from internal government accounts. ### get_avg_interest_rates Gets the average interest rates on U.S. Treasury securities (updated monthly). ### get_treasury_auctions Retrieves results for recent Treasury securities auctions (Bills, Notes, and Bonds). ## Prompt Examples **Prompt:** ``` What is the exact current U.S. National debt? ``` **Response:** ``` 📊 **U.S. Treasury: Debt to the Penny** The most recent data (2026-03-31): - Total Public Debt Outstanding: $34,812,456,789.12 - Intragovernmental Holdings: $7,123,456,789.12 - Debt Held by the Public: $27,689,000,000.00 ``` **Prompt:** ``` What is the average interest rate on Treasury Bills? ``` **Response:** ``` 📊 **U.S. Treasury Average Interest Rates** Average interest rates for March 2026: - Treasury Bills: 5.12% - Treasury Notes: 4.58% - Treasury Bonds: 4.75% ``` **Prompt:** ``` Show me the result of the last Treasury auction ``` **Response:** ``` 📊 **Treasury Auctions** Recent 10-Year Treasury Note Auction (2026-03-15): - Amount Accepted: $42,000,000,000 - High Yield: 4.25% - Bid-to-Cover Ratio: 2.54 ``` ## Capabilities ### Track Total Debt to the Penny Instantly retrieve the total U.S. national debt outstanding, broken down by public holdings and government trusts. ### Analyze Historical Debt Trends Pull historical debt figures for specific date ranges (e.g., tracking debt growth across multiple presidencies). ### Calculate Current Borrowing Costs Get the current average interest rates on U.S. Treasury securities, showing the cost of servicing the national debt. ### Detail Debt Components View a precise breakdown of public debt by separating funds held by the market from intragovernmental holdings. ### Measure Market Demand Retrieve results and metrics from Treasury auctions, including the bid-to-cover ratio to gauge investor appetite. ## Use Cases ### Assessing Debt Growth Over a Decade A policy researcher wants to see how national debt has grown since the 2008 crisis. They ask their agent to use `get_debt_history` with specific start and end dates (e.g., 2008-10-01 to 2018-10-01). The agent runs the tool, providing a clear timeline of debt accumulation that would otherwise require downloading and manually charting multiple datasets. ### Evaluating Current Market Confidence A risk manager needs to know if institutional investors are buying up U.S. bonds aggressively. They use `get_treasury_auctions` to pull the latest results. The agent provides the bid-to-cover ratio, letting the manager instantly assess market demand without navigating complex auction reports. ### Comparing Total Debt vs. Public Holdings A financial analyst is writing a report and needs to distinguish between total debt and what's sold on the open market. They run `get_national_debt` for the total, then use `get_public_debt_breakdown` to isolate the exact amount held by the public, ensuring their figures are technically correct. ### Calculating Immediate Borrowing Cost A journalist needs a quick number: What is the average interest cost on Treasury securities right now? They ask for the rates and the agent calls `get_avg_interest_rates`, delivering the current percentages across Bills, Notes, and Bonds in seconds. ## Benefits - Get the precise total: The `get_national_debt` tool delivers the full public debt figure to the penny daily. You don't have to piece together numbers from multiple government pages; you just ask for it. - Contextualize the cost of borrowing: Using `get_avg_interest_rates`, you immediately see what rate the federal government is paying right now. This gives context to the size of the debt figure. - See the funding mechanics: The `get_public_debt_breakdown` separates the market's holdings from internal funds. Knowing this difference is critical for accurate financial analysis. - Gauge investor demand quickly: Running `get_treasury_auctions` shows if markets are confident in U.S. debt through key metrics like the bid-to-cover ratio. - Model long-term shifts: The `get_debt_history` tool lets you compare current figures to specific historical periods, turning raw numbers into actionable trends. ## How It Works The bottom line is: You ask for the specific financial data point, and the agent gets the raw number from the Treasury Department immediately. 1. You tell your agent exactly what metric you need (e.g., 'Show debt for 2018' or 'What are the current interest rates?'). 2. The agent calls the appropriate tool, like `get_debt_history` or `get_avg_interest_rates`, passing any required parameters. 3. The server returns clean, structured data—the actual numbers and metrics—which your AI client uses to build a direct answer for you. ## Frequently Asked Questions **How do I get the current total U.S. National debt using get_national_debt?** Just ask your agent for 'the national debt.' The `get_national_debt` tool provides the latest figure, broken down into its public and intragovernmental components. **Can I track historical interest rates with get_avg_interest_rates?** No. `get_avg_interest_rates` provides the average rate updated monthly for the current period. For historical tracking, you need to use `get_debt_history` instead. **What is the difference between public debt and intragovernmental holdings?** The `get_public_debt_breakdown` tool shows this split. 'Publicly held' money means it's available to the market; 'Intragovernmental' refers to funds within government trust accounts. **How do I check recent bond sales? Does get_treasury_auctions work?** Yes, `get_treasury_auctions` pulls the latest results for Bills, Notes, and Bonds. It's useful for seeing metrics like the bid-to-cover ratio. **What is the best way to compare debt across presidential terms?** Use `get_debt_history`. You specify a date range that covers multiple presidencies, and it pulls the corresponding national debt figures for those dates. **How do I format dates when using get_debt_history?** You must provide the start and end dates in YYYY-MM-DD format. The tool uses this range to track total debt growth over your selected period, whether it's a fiscal year or a specific crisis timeframe. **Does get_avg_interest_rates cover all types of U.S. debt? ** Yes, the average rates cover Treasuries across Bills, Notes, and Bonds. Keep in mind these figures are updated monthly, reflecting the cost of borrowing for the federal government that month. **What detailed data does get_public_debt_breakdown provide?** It gives you a statement showing both Debt Held by the Public and Intragovernmental Holdings. This breakdown lets you see exactly how the total public debt is structured by security type. **What is 'Debt to the Penny'?** It is the exact daily public debt of the United States, updated each business day. It includes all Treasury securities issued to the public. **How often are the interest rates updated?** Average interest rates are typically reported at the end of each month. **Do I need authentication?** No, all Treasury Fiscal Data API endpoints are public and do not require API keys.