Treasury Tic MCP server

@pipeworx/treasury-tic

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.

Part of Pipeworx — an MCP gateway connecting AI agents to 1837+ live data sources. This is an independent, unofficial integration — not affiliated with, endorsed by, or published by the upstream provider.

Tools

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.

• ticforeignholdings(country?, month?, limit?) — foreign holdings of U.S.

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.

• ticmajortreasury_holders(country?, month?, limit?) — the "Major Foreign

Auth

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

Data sources

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.

• U.S. Department of the Treasury, Treasury International Capital (TIC)

Cadence and coverage

August data in mid-October).

• Monthly, published roughly 6 weeks after the reference month (e.g.

regional/institutional-sector aggregates (totals, "Of Which:" breakouts), back to 2011 or earlier for most countries.

• ticforeignholdings covers essentially every country and a set of

holders; everyone else is folded into "All Other". Asking it for a smaller country returns found: false with a pointer to ticforeignholdings instead, which does cover that country.

• ticmajortreasury_holders only names the ~20 largest individual

Common pitfalls

treasuryholdingsusdmil for a country and ticmajortreasuryholders's holdingsusdbil 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.

• These two tools answer different questions. ticforeignholdings's

ticmajortreasury_holders reports USD billions — each response carries its own unit field, read it rather than assuming.

• Units differ: ticforeignholdings reports USD millions,

resolves to "China, Mainland" via a small alias table; an unresolvable name returns found: false with suggestions rather than an empty result.

• A country name has to resolve to the publisher's own label. "China"

mid-month correction to a prior month's figure shows up immediately rather than being frozen at whatever we first saw.

• Revisions happen. Both files are refetched live on every call, so a

Quick Start

Add to your MCP client (Claude Desktop, Cursor, Windsurf, etc.):

{
  "mcpServers": {
    "treasury-tic": {
      "url": "https://gateway.pipeworx.io/treasury-tic/mcp"
    }
  }
}

What this endpoint actually serves

Shortened. The full README is on GitHub.