Treasury Debt Research — tool reference

Server URL: https://toolcargo.com/mcp/treasury · Scope: connector:treasury. Activate Site Audit free and use ToolCargo OAuth or a scoped API key. No Treasury account, provider key or paid upstream. Each successful operation uses one shared-plan call.

treasury_debt_series

{ "startDate": "2026-09-28", "endDate": "2026-10-02" }

Choose an explicit inclusive window of 1–31 calendar days, from 2005-04-04 through today UTC. One bounded source query returns reported publication dates, total public debt outstanding, debt held by the public and intragovernmental holdings. Missing calendar dates are listed separately; no weekend, holiday or outage explanation is inferred. There is no automatic paging, nearest-date substitution or latest-date default.

treasury_debt_compare

{ "fromDate": "2026-09-28", "toDate": "2026-10-01" }

Choose two distinct dates in chronological order within the same supported history. Each exact record is fetched separately. Preserve both source records and retrieval times; they are not an atomic snapshot. Missing records remain explicit and missing components cannot produce a calculated difference. Available differences are ToolCargo calculations in exact decimal USD, not floating-point approximations.

Amounts and interpretation

Amounts are original decimal US-dollar strings with cents; ToolCargo does not divide them into millions or billions. Source string-null or JSON-null values stay missing. Published zeros are preserved as recorded, while the source warns that some older component history used zero placeholders. The supported era starts when daily component data begins; missing or zero fields do not establish a complete historical breakdown.

These are outstanding debt stocks. A difference between two stocks is not the budget deficit, gross borrowing, a debt-limit compliance finding, debt-to-GDP or a personal financial recommendation. Treasury’s separate Monthly Treasury Statement is not exposed by this connector.

Publication dates and revisions

The source defines record_date as publication date and describes business-day updates with previous-business-day data. ToolCargo retains the source date without shifting it or inventing an economic as-of instant. fetchedAt is retrieval time. Source update timestamps and immutable revision identities are unavailable and remain null; do not claim real-time balances or permanently final historical values.

Source validation and bounds

Only the fixed Debt to the Penny endpoint and selected fields are requested. ToolCargo validates complete counts, field types and formats, calendar dates, unique records and the requested date scope. Links are not followed. A shared exact-token provider lease serializes at most two starts per operation, spaced at least 1.1 seconds apart, with source Retry-After cooldown. JSON responses are bounded to 256 KiB and 15 seconds within a 35-second operation. No result cache, stale fallback, redirects, automatic retries, arbitrary queries, downloads or credential forwarding.

Source and attribution

Data source: U.S. Department of the Treasury, Bureau of the Fiscal Service. Preserve the dataset link, publication dates and retrieval times. ToolCargo selects, validates and orders metadata and computes labelled differences; this is not Treasury-authored output or endorsement. Treasury offers the underlying data freely for commercial and non-commercial reuse. ToolCargo plan charges concern hosted access and processing; the source data remain freely available at Treasury.

Primary references: Debt to the Penny definitions · Fiscal Data API, licensing and response fields.