taiwan_foreign_holdings
Pack: taiwan-stocks · 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/taiwan_foreign_holdings for the schema, then POST the same URL with its arguments for the data.
How much of the Taiwan stock market foreign and mainland-China investors own, from the TWSE QFII register — either the securities with the highest overseas ownership and their remaining headroom under the statutory ceiling, or ownership share broken down by sector. Answers “how much of TSMC do foreigners own”, “foreign ownership of Taiwanese banks”.
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
mode | string | no | top_holdings = the most foreign-owned securities. by_industry = ownership share per sector. Default top_holdings. |
limit | number | no | Rows to return in top_holdings mode, 1-40. Default 20. |
Example call
Arguments
{
"mode": "top_holdings",
"limit": 3
}
curl
curl -X POST https://gateway.pipeworx.io/taiwan-stocks/mcp \
-H 'Content-Type: application/json' \
-d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"taiwan_foreign_holdings","arguments":{"mode":"top_holdings","limit":3}}}'
TypeScript (@pipeworx/sdk)
import { Pipeworx } from '@pipeworx/sdk';
const pipeworx = new Pipeworx();
const result = await pipeworx.call('taiwan_foreign_holdings', {
"mode": "top_holdings",
"limit": 3
});
More examples
{
"mode": "by_industry"
}
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 taiwan-stocks pack
{
"mcpServers": {
"taiwan-stocks": {
"url": "https://gateway.pipeworx.io/taiwan-stocks/mcp"
}
}
}
See Getting Started for client-specific install steps.