U.S. Treasury Debt MCP for AI. Track national debt, interest rates, and auction results instantly.

Q: How do I get the current total U.S. National debt using getnationaldebt?

Just ask your agent for 'the national debt.' The getnationaldebt tool provides the latest figure, broken down into its public and intragovernmental components.

Q: Can I track historical interest rates with getavginterestrates?

No. getavginterestrates provides the average rate updated monthly for the current period. For historical tracking, you need to use getdebthistory instead.

Q: What is the difference between public debt and intragovernmental holdings?

The getpublicdebtbreakdown tool shows this split. 'Publicly held' money means it's available to the market; 'Intragovernmental' refers to funds within government trust accounts.

Q: How do I check recent bond sales? Does gettreasuryauctions work?

Yes, gettreasuryauctions pulls the latest results for Bills, Notes, and Bonds. It's useful for seeing metrics like the bid-to-cover ratio.

Q: What is the best way to compare debt across presidential terms?

Use getdebthistory. You specify a date range that covers multiple presidencies, and it pulls the corresponding national debt figures for those dates.

Claude

ChatGPT

Cursor

Gemini

Windsurf

VS Code

JetBrains

Vercel

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

Connect to your AI in seconds.

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.

What your AI can do

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.

+ 2 more capabilities included

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.

Ask an AI about this

Included with Plan

Waiting for input…

AI Agent

U.S. Treasury Debt: 5 Tools for Fiscal Data

These tools allow you to pull precise financial metrics, including total debt figures, interest costs, and market auction results from the U.S. Department of the Treasury.

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 U.S. Treasury Debt — National Debt & Interest Rates on Vinkius

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...

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).

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

Open Claude Settings

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

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.

Start a conversation

Open a new chat. The U.S. Treasury Debt integration is available immediately — no restart needed.

Antigravity

Configure Agent Environment

Open your Antigravity agent's workspace configuration or mcp-servers.json file.

Bind the Endpoint

Add the Vinkius endpoint URL to your agent's MCP connections list:

"mcp_servers": {
  "us-treasury-debt-national-debt-interest-rates": {
    "serverUrl": "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
  }
}

Provide your secure token in place of [YOUR_TOKEN_HERE] to ensure your agent requests are authenticated.

Execute

Start your Antigravity session. The agent will autonomously discover and utilize the U.S. Treasury Debt tools with full Vinkius guardrails applied.

VS Code Copilot

⚡

One-Click Install (Recommended)

In your Vinkius Dashboard, simply click the Add to VS Code button for this server. We'll automatically configure your local workspace.

Or configure manually

Open MCP Settings

Open VS Code, press Ctrl/Cmd + Shift + P, and search for GitHub Copilot: MCP Servers.

Add Server Config

Add the Vinkius endpoint configuration to your mcp-servers.json file:

"us-treasury-debt-national-debt-interest-rates": {
  "url": "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
}

Ensure you replace [YOUR_TOKEN_HERE] with your token from cloud.vinkius.com.

LangChain

Install Dependencies

Install the LangChain MCP adapters for your environment:

pip install langchain-mcp-adapters

Connect the Server

Use the SSEClient in LangChain to connect to the Vinkius managed endpoint:

from langchain_mcp_adapters.client import SSEClient

# Connect to Vinkius
client = SSEClient(url="https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp")
tools = client.get_tools()

CrewAI

Define the Tool

Load the Vinkius MCP tools into your CrewAI agents:

from crewai import Agent
from mcp_crewai import MCPTool

# Connect securely to Vinkius
vinkius_tools = MCPTool(url="https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp")

# Assign to Agent
researcher = Agent(
    role='Data Researcher',
    tools=vinkius_tools.get_all()
)

Execute Task

Run your CrewAI process. The agent will autonomously route tasks to the Vinkius managed server.

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 U.S. Treasury Debt — National Debt & Interest Rates, 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

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

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 5 powerful capabilities that interface natively with Claude, ChatGPT, Cursor, and other compatible AI platforms. No middleware. No custom integration required.

Reading federal debt numbers used to mean downloading a dozen spreadsheets and cross-referencing six different government tabs.

A financial analyst today has to manually check the Treasury's main page for the total, then go to another link for the breakdown of holdings, and maybe jump to a third site just to pull historical dates. It’s painstaking work—hours spent on copy-pasting data into Excel just to get one clean chart.

With this MCP Server, your agent handles all that legwork. You simply ask for 'national debt over the last three election cycles.' The agent runs `get_debt_history` and packages the full timeline instantly. You get the finished chart's data without opening a single browser tab.

The U.S. Treasury Debt — National Debt & Interest Rates MCP Server synthesizes five key metrics into one actionable dataset.

Before, if you wanted to understand the cost of debt, you had to check three places: 1) The total amount (`get_national_debt`), 2) What that money costs to borrow right now (`get_avg_interest_rates`), and 3) How much the market thinks it's worth (`get_treasury_auctions`). It was a disjointed, multi-step research project.

Now, you ask one question. The agent calls `get_national_debt`, then feeds that figure into context with `get_avg_interest_rates` and the latest auction data from `get_treasury_auctions`. You get an integrated answer—a complete picture of risk, cost, and scale.

Support 24/7 support@vinkius.com ↗

Security Vinkius Trust Center ↗

SLA Service Level Agreement ↗

Report Listing Send Report ↗

What your AI can actually do with this

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.

Built · Hosted · Managed by Vinkius U.S. Treasury Debt - National Debt & Interest Rates MCP

Server ID 019d7615-3752-730c-ac61-ac4a04cd9fe5

Vinkius Inspector

Compliance Grade A+

Score 100/100

Report View Report ↗

Here's how it actually 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.

You tell your agent exactly what metric you need (e.g., 'Show debt for 2018' or 'What are the current interest rates?').

The agent calls the appropriate tool, like get_debt_history or get_avg_interest_rates, passing any required parameters.

The server returns clean, structured data—the actual numbers and metrics—which your AI client uses to build a direct answer for you.

Who is this actually for?

This is for financial analysts and policy researchers who need hard numbers, not headlines. If you're a macroeconomist tired of stitching together data from five different government websites, this saves hours. It’s built for people whose job requires knowing the precise difference between public debt and intragovernmental holdings.

Financial Analyst

Uses get_public_debt_breakdown to model risk scenarios, separating market-held debt from internal government funds.

Macroeconomist

Runs get_debt_history and compares it with rates from get_avg_interest_rates to chart long-term fiscal trends over decades.

Risk Manager

Checks get_treasury_auctions results, specifically the bid-to-cover ratio, to assess current market confidence in U.S. debt.

What Changes When You Connect

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.

See it in action

01 01

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.

02 02

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.

03 03

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.

04 04

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.

The honest tradeoffs

Assuming one number is enough

Anti-pattern

The user asks: 'What's the national debt?' and gets a single total number. They then assume that figure tells them everything about the government’s financial health.

The Fix

Don't stop there. Always follow up by running get_public_debt_breakdown to see where the money is held, and run get_avg_interest_rates to calculate the cost of servicing that total debt.

Only checking current totals

Anti-pattern

The user checks get_national_debt today but ignores how much it was last year. They miss critical context about growth rates.

The Fix

Use get_debt_history. Input the start date from a previous fiscal year to track debt momentum and see if the rate of increase is accelerating or slowing.

Mixing up debt types

Anti-pattern

The user confuses 'Total Debt' with 'Publicly Held Debt.' They cite the overall number, which includes internal trust funds that aren't market assets.

The Fix

Use get_public_debt_breakdown. This tool gives you the clean separation: what is held by trusts versus what is actually available to trade on the open market.

When It Fits, When It Doesn't

You should use this MCP Server if your analysis requires hard, verifiable numbers about federal debt structure, cost of borrowing, or market demand. You need to model trends (use get_debt_history) or compare different segments of the debt (use get_public_debt_breakdown). Don't use it if you just want a general news summary—a quick search engine query is faster. If your goal is simply 'Is the economy good?' this tool won't tell you that, but it will give you the raw data points needed for you to draw those conclusions.

Questions you might have

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.

Connect to your AI in seconds.

Get national debt

Get debt history

Get public debt breakdown

U.S. Treasury Debt: 5 Tools for Fiscal Data

Make your AI actually useful.

Get National Debt

Get Debt History

Get Public Debt Breakdown

Get Avg Interest Rates

Get Treasury Auctions

Security and governance baked right in.

Claude AI

Open Claude Settings

Add Custom Connector

Start a conversation

Claude Code

Open your terminal

Add the MCP Server

Start coding

Cursor

One-Click Install (Recommended)

Open Cursor Settings

Add New Server

Use in Composer

Antigravity

Configure Agent Environment

Bind the Endpoint

Execute

VS Code Copilot

One-Click Install (Recommended)

Open MCP Settings

Add Server Config

Windsurf

One-Click Install (Recommended)

Open Windsurf Settings

Add Server Endpoint

LangChain

Install Dependencies

Connect the Server

CrewAI

Define the Tool

Execute Task

Choose How to Get Started

Build Your Own

Make Your AI Do More

Works with Claude, ChatGPT, Cursor, and more

Reading federal debt numbers used to mean downloading a dozen spreadsheets and cross-referencing six different government tabs.

The U.S. Treasury Debt — National Debt & Interest Rates MCP Server synthesizes five key metrics into one actionable dataset.

What your AI can actually do with this

Here's how it actually works

Who is this actually for?

What Changes When You Connect

See it in action

Assessing Debt Growth Over a Decade

Evaluating Current Market Confidence

Comparing Total Debt vs. Public Holdings

Calculating Immediate Borrowing Cost

The honest tradeoffs

Assuming one number is enough

Only checking current totals

Mixing up debt types

When It Fits, When It Doesn't

Questions you might have