@pipeworx/taiwan-stocks

Connect: https://gateway.pipeworx.io/taiwan-stocks/mcp · Install: one-click buttons

Tools: 11

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.

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 boards. Company profiles, monthly revenue, disclosures, foreign holdings and the ex-dividend calendar are TWSE main-board files; a TPEx symbol comes back with found: false and a reason saying so rather than an empty result.
• Publication timing. Both exchanges publish after the 13:30 Taipei close, so before then the newest session shown is the previous trading day.
• Monthly revenue amounts are in thousands of TWD; margin balances are in lots of 1,000 shares.

Data sources

• TWSE open data — https://openapi.twse.com.tw/v1 (spec)
• TPEx open data — https://www.tpex.org.tw/openapi/v1 (spec)

Tools

• taiwan_stock_quote — Daily close, open, high, low, change, share volume and TWD turnover for Taiwan-listed stocks and ETFs, from the Taiwan Stock Exchange (TWSE, 上市) and Taipei Exchange (TPEx, 上櫃) open data. Accepts the n
• taiwan_search_securities — Find a Taiwan-listed security by company name, English abbreviation or numeric code across both the TWSE main board and the TPEx OTC board. Returns code, Chinese name, English abbreviation, market and
• taiwan_company_profile — Corporate profile of a TWSE-listed Taiwanese company from the exchange company master: English abbreviation, sector, chairman and president, incorporation and listing dates, paid-in capital, shares ou
• taiwan_market_summary — Daily level and change of the TAIEX (發行量加權股價指數, the Taiwan Stock Exchange benchmark) and the TPEx OTC index, with total market turnover, share volume and transaction count per session. Answers “where
• taiwan_stock_valuation — Price-to-earnings ratio, dividend yield and price-to-book for Taiwan-listed shares, as published daily by TWSE and TPEx. Answers “what is TSMC trading at in P/E terms”, “dividend yield on 2412”, “is 2
• taiwan_monthly_revenue — Monthly sales (月營收) reported by TWSE-listed companies: the month’s revenue with month-on-month and year-on-year change, plus year-to-date totals. Taiwan mandates this disclosure by the 10th of the fol
• taiwan_material_news — Mandatory same-day corporate disclosures (重大訊息) filed by TWSE-listed companies: board resolutions, mergers and acquisitions, large asset transactions, litigation, capital raises, name changes. Returns
• taiwan_top_traded — The twenty most heavily traded securities on the Taiwan Stock Exchange in the latest session, ranked by share volume, with each one’s open, high, low, close and transaction count. Answers “what is bei
• taiwan_foreign_holdings — 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
• taiwan_margin_balance — Margin financing (融資) and short-sale (融券) balances for a Taiwan-listed stock, with the day’s buys, sells, covering and the exchange quota. Rising margin balance means leveraged retail buying; rising s
• taiwan_ex_dividend_calendar — Announced ex-dividend and ex-rights dates for TWSE-listed securities, with the cash dividend per share, stock dividend ratio and any subscription terms. Answers “when does 2330 go ex-dividend”, “which