`tic_foreign_holdings`

Pack: treasury-tic · Connect: https://pipeworx.io/mcp (see Connect below for a single-pack URL)

No MCP client? Call it directly: GET https://gateway.pipeworx.io/v1/tools/tic_foreign_holdings for the schema, then POST the same URL with its arguments for the data.

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, net U.S. purchases/sales and a valuation-change breakdown. Pass “country” for one country’s recent history (e.g. “Japan”, “China”); omit it for a ranking of the largest foreign holders of U.S. securities in a given month (default: most recently published). Monthly cadence, published with roughly a 6-week lag. Answers “how much does Japan hold in US securities”, “who are the biggest foreign holders of US stocks and bonds”, “has China been buying or selling US Treasuries”.

Parameters

Name	Type	Required	Description
`country`	string	no	Country name, e.g. “Japan”, “China”, “United Kingdom”. Omit for a cross-country ranking.
`month`	string	no	YYYY-MM. Omit for the most recently published month.
`limit`	number	no	Ranking mode: how many countries to return (1-50, default 20). Country mode: how many recent months of history (1-60, default 12).

Example call

Arguments

{
  "limit": 5
}

curl

curl -X POST https://gateway.pipeworx.io/treasury-tic/mcp \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"tic_foreign_holdings","arguments":{"limit":5}}}'

TypeScript (@pipeworx/sdk)

import { Pipeworx } from '@pipeworx/sdk';
const pipeworx = new Pipeworx();

const result = await pipeworx.call('tic_foreign_holdings', {
  "limit": 5
});

More examples

{
  "country": "China",
  "limit": 3
}

Connect

Add this to your MCP client config — every tool in the catalog, including this one — or use one-click install buttons:

{
  "mcpServers": {
    "pipeworx": {
      "url": "https://pipeworx.io/mcp"
    }
  }
}

Connect to just the treasury-tic pack

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

See Getting Started for client-specific install steps.

tic_foreign_holdings