U.S. Treasury Debt Research

Live

Research reported U.S. debt with exact amounts and dates.

Inspect bounded Debt to the Penny history and compare two exact source dates. Keep decimal USD amounts, public and intragovernmental components, source nulls and retrieval dates visible, with labeled ToolCargo calculations.

Connect this tool ↗Tool reference

Connect / 2 tools

Server URL

streamable http

https://toolcargo.com/mcp/treasury

Claude Code

terminal

claude mcp add --transport http --scope user toolcargo-treasury https://toolcargo.com/mcp/treasury \
  --header "Authorization: Bearer YOUR_API_KEY"

Create a key in your dashboard. Other clients: setup guides.

What it helps you do

Bounded reported-debt history
Exact dated composition comparisons
Labeled decimal changes and source gaps

Built for: Research agents investigating reported U.S. federal debt composition and changes.

Example requests

Compare reported debt composition

“Read Treasury debt records from 2026-09-28 through 2026-10-01, then compare the exact first and last source dates. Keep USD decimals and missing components intact, cite retrieval dates and identify calculations by ToolCargo. Explain why stock changes are not the federal budget deficit.”

A source-linked series and exact dated comparison with component changes, missing-state disclosure and separate retrieval times.

Explore useful agent workflows ↗

Tools

Tool	What it does	Access
`treasury_debt_series` Research U.S. debt composition over time	Read 1–31 explicit calendar days of Treasury Debt to the Penny records from 2005-04-04 onward. Preserve exact decimal USD debt stock, public/intragovernmental components and source nulls; list unreturned dates without inventing weekend or outage explanations. Record Date is the source publication field, not an inferred economic as-of instant. One shared-plan call.	Read-only
`treasury_debt_compare` Compare two exact reported debt dates	Inspect two distinct ordered source dates from 2005-04-04 onward and calculate exact two-decimal USD changes for total debt and its components. Missing dated records or amounts remain explicit missing; no nearest-business-day substitution. Two sequential fresh requests are not an atomic snapshot. Stock differences are not borrowing flows, budget deficits or financial advice. One shared-plan call.	Read-only

Requirements

• A ToolCargo account with Site Audit activated (free). No Treasury account, API key or paid provider.

Limitations

• Debt to the Penny only, dates from 2005-04-04 through today UTC. Series cover 1–31 inclusive calendar days; comparison uses two distinct ordered exact dates. No arbitrary datasets, downloads or nearest-date aliases. Monthly Treasury Statement tools remain inactive.
• Exact raw decimal USD debt stock, not debt subject to limit, borrowing flows, federal budget deficit, debt/GDP, forecasts or investment advice. Changes are labeled ToolCargo calculations without scaling or annualization.
• Record Date retains the source publication-date definition; Treasury describes previous-business-day data at end-of-business-day updates. No inferred economic as-of timestamp or shifted date. Unreturned dates remain unclassified gaps.
• String-null and JSON-null amounts remain explicit source_null, never zero. Treasury documents historical zero placeholders and earlier sparse component frequency; raw zeros remain unchanged without a measured-breakdown guarantee.
• Source update time, immutable revision and finality are unavailable. Comparisons fetch sequentially with separate retrieval dates and are not atomic snapshots. Selected field definitions, count, dates and paging are checked, but the complete query is not echoed.
• Fresh requests without result caching, redirects or retries: fixed Treasury HTTPS endpoint, 256 KiB/15-second response bound, at most two serial requests per operation and 35-second operation deadline. Shared provider pacing and source-directed cooldown may defer requests; no unlimited-access or numeric source quota promise.
• Treasury permits commercial/non-commercial copying, adaptation and redistribution of these data. Cite Treasury and retrieval dates, identify ToolCargo projection/calculations and avoid endorsement claims. No blanket CC0, seal/logo or linked third-party asset permission is claimed; ToolCargo fees cover its service, not purchase of free Treasury data.

Supported clients

“Tested” means we connected that client to this endpoint and ran a tool call ourselves. Recorded client-specific tests currently cover Site Audit. Other connectors use the documented setup until tested in that client.

Claude Code	API key header	Documented, not yet tested	This endpoint has not yet been tested in this client. See the setup guide.
Claude (claude.ai)	OAuth sign-in	Documented, not yet tested	This endpoint has not yet been tested in this client. See the setup guide.
Cursor	API key header	Documented, not yet tested	This endpoint has not yet been tested in this client. See the setup guide.
VS Code (Copilot agent mode)	API key header	Documented, not yet tested	This endpoint has not yet been tested in this client. See the setup guide.
ChatGPT (developer mode)	OAuth sign-in	Documented, not yet tested	This endpoint has not yet been tested in this client. See the setup guide.
MCP Inspector	API key header	Documented, not yet tested	This endpoint has not yet been tested in this client. See the setup guide.

Practical workflows

Research U.S. Treasury debt records with AI and MCP

Pricing

Treasury provides source data freely. ToolCargo hosting and workflow access are included with Site Audit; each successful series or comparison consumes one shared-plan call.

Free

Try hosted tools with a shared monthly allowance.

50 shared calls/month

Pro

$12/mo

Proposed larger shared allowance; see checkout status on the pricing page.

2,000 shared calls/month

Proposed test price. See the pricing page for checkout status.

Full pricing and billing details