@pipeworx/taiwan-stocks

Taiwan equities MCP — prices, valuations, monthly sales, disclosures, margin balances and dividend dates for companies listed on the Taiwan Stock Exchange (TWSE, 上市) and the Taipei Exchange (TPEx, 上櫃). Keyless.

Part of Pipeworx — an MCP gateway connecting AI agents to 1683+ live data sources.

Tools

• taiwan_stock_quote(symbols) — daily open/high/low/close, change, share volume and TWD turnover. Covers both boards.
• taiwan_search_securities(query, market?, limit?) — resolve a company name, English abbreviation or code to a listed security.
• taiwan_company_profile(symbol) — sector, chairman, president, incorporation and listing dates, paid-in capital, shares outstanding, auditor, website. TWSE main board.
• taiwan_market_summary(days?) — TAIEX and TPEx index levels with market-wide turnover, volume and transaction counts per session.
• taiwan_stock_valuation(symbols) — P/E, dividend yield and price-to-book as published daily by each exchange.
• taiwan_monthly_revenue(symbol?, industry?, limit?) — monthly sales (月營收) with MoM, YoY and year-to-date change; or a sector ranked by revenue growth.
• taiwan_material_news(symbol?, query?, limit?) — mandatory same-day disclosures (重大訊息): board resolutions, M&A, litigation, capital raises.
• taiwan_top_traded(limit?) — the twenty most heavily traded TWSE securities of the session.
• taiwan_foreign_holdings(mode?, limit?) — foreign and mainland-China ownership, by security or by sector, with headroom under the statutory ceiling.
• taiwan_margin_balance(symbols) — margin financing (融資) and short-sale (融券) balances with the day's activity and quotas.
• taiwan_ex_dividend_calendar(symbol?, limit?) — announced ex-dividend and ex-rights dates with cash and stock terms.

Auth

None. Both exchanges publish these as open data with no key and no quota.

Input conventions

Every tool that takes a symbol accepts three forms interchangeably:

Codes are trusted without a company lookup, because ETFs and warrants trade on TWSE without appearing in the company master.

Gotchas

• Two calendars in one API. Most endpoints stamp the Republic-of-China year (1150819 = 2026-08-19, 11507 = 2026-07); MI_INDEX20 and the TPEx index history stamp plain Gregorian (20260819). The pack normalizes both to ISO.
• Some JSON keys carry trailing spaces — the disclosure feed's subject field is literally "主旨 ". Every key is trimmed on ingest.
• These are whole-market files, not per-symbol endpoints. There is no /quote/2330; the smallest unit is "everything that traded today" (318 KB on TWSE, ~4 MB on TPEx). The pack fetches the market file, caches it in-isolate for 5 minutes, and always tries the smaller TWSE file before falling through to TPEx.
• TPEx refuses Cloudflare egress (open). From the deployed gateway, www.tpex.org.tw answers HTTP 520 and then a redirect loop into /errors; the identical URL with the worker's exact User-Agent and Accept headers returns 200 from a laptop, so it is the egress IP, not the request. The pack routes TPEx through the egress relay when the gateway injects one and falls back to direct egress if the relay answers host_not_allowed, so the two can deploy in either order. www.tpex.org.tw is in the relay's allow-list source but the edge function has not been redeployed yet — until it is, TPEx calls fail and every tool degrades rather than throwing: TWSE results come back complete alongside tpex_unavailable: true and a reason, and an OTC symbol returns reason: "tpex_unreachable" instead of an empty result. An OTC security we could not reach and one that does not exist are different answers.
• Coverage split. Quotes, valuations and margin balances cover both b

... View full README on GitHub