@pipeworx/treasury-tic

Connect: https://pipeworx.io/mcp — every tool in the catalog, including @pipeworx/treasury-tic’s. Install: one-click buttons

No MCP client? Skip the connection: POST https://gateway.pipeworx.io/v1/tools/search_packs {"query":"..."} to find a tool below, GET /v1/tools/<name> for its schema, POST the same URL with arguments for the data — see For AI agents.

Tools: 2

Foreign holdings of U.S. securities, by country and month, from the U.S. Treasury’s Treasury International Capital (TIC) System — the capital-flows survey behind “China holds $X of US Treasuries” headlines. This is a different Treasury system from the daily fiscal ledger the treasury-fiscal pack covers, and a series FRED does not carry.

Tools

• tic_foreign_holdings(country?, month?, limit?) — foreign holdings of U.S. long-term securities (Treasury, agency bonds, corporate bonds, corporate equity) by country and month. Pass country for one country’s recent history; omit it for a ranking of the largest foreign holders in a given month.
• tic_major_treasury_holders(country?, month?, limit?) — the “Major Foreign Holders of Treasury Securities” ranking: the ~20 largest individual foreign holders of U.S. Treasury securities plus an “All Other” bucket, the grand total, and the foreign-official-sector (central bank/government) split. This is the specific number financial press quotes per country.

Auth

Keyless. The upstream answers without a credential, and no _apiKey is accepted.

Data sources

• U.S. Department of the Treasury, Treasury International Capital (TIC) System — the monthly survey of foreign holdings of U.S. long-term securities, broken out by country and security type, and the Major Foreign Holders of Treasury Securities ranking derived from it. U.S. federal government data; no reuse restriction.

Cadence and coverage

• Monthly, published roughly 6 weeks after the reference month (e.g. August data in mid-October).
• tic_foreign_holdings covers essentially every country and a set of regional/institutional-sector aggregates (totals, “Of Which:” breakouts), back to 2011 or earlier for most countries.
• tic_major_treasury_holders only names the ~20 largest individual holders; everyone else is folded into “All Other”. Asking it for a smaller country returns found: false with a pointer to tic_foreign_holdings instead, which does cover that country.

Common pitfalls

• These two tools answer different questions. tic_foreign_holdings’s treasury_holdings_usd_mil for a country and tic_major_treasury_holders’s holdings_usd_bil for the same country/month should be close (same underlying survey) but are not guaranteed byte-identical — the Major Foreign Holders ranking is Treasury’s own derived table, not a mechanical re-slice of Table 1.
• Units differ: tic_foreign_holdings reports USD millions, tic_major_treasury_holders reports USD billions — each response carries its own unit field, read it rather than assuming.
• A country name has to resolve to the publisher’s own label. “China” resolves to “China, Mainland” via a small alias table; an unresolvable name returns found: false with suggestions rather than an empty result.
• Revisions happen. Both files are refetched live on every call, so a mid-month correction to a prior month’s figure shows up immediately rather than being frozen at whatever we first saw.

Tools

• tic_foreign_holdings — Foreign holdings of U.S. long-term securities by country and month, from ${PUBLISHER}‘s ${DATASET_1}. Covers Treasury securities, agency bonds, corporate bonds and corporate equity, each with holdings
• tic_major_treasury_holders — The “Major Foreign Holders of Treasury Securities” ranking from ${PUBLISHER}‘s ${DATASET_MFH} — the figure financial press cites as ” holds $X of US Treasuries.” Covers the ~20 largest indivi