Skip to content
MCP server

Taiwan Stocks

Keyless MCP server for Taiwan-listed stock prices, valuations, filings and dividend dates

Install
Pricing
Freemium
Platforms
API, CLI, self-hosted
Runs
Locally or Remotely
Version
0.2.1
Listing updated
today

Similar MCP servers

About Taiwan Stocks

Taiwan Stocks is a freemium MCP server for finance and payments. It can run locally on your machine or as a hosted remote server.

The README says the server covers daily quotes, P/E and dividend yield, monthly revenue, same-day material disclosures, margin balances and ex-dividend dates for companies on the Taiwan Stock Exchange and the Taipei Exchange. Symbols can be given as numeric codes, exchange English abbreviations or Chinese names, so a single lookup tool resolves the security before the other calls run.

It is delivered through the Pipeworx gateway over streamable HTTP, or as an npm stdio bridge that calls the same endpoint. The README notes that the connection also lists shared gateway meta-tools such as ask_pipeworx alongside the pack's own tools. Calls are anonymous and capped daily without a free Pipeworx key.

The README also flags that TPEx (OTC board) data may be unavailable on the gateway until a relay change is deployed; in that state TWSE results still return and OTC symbols report an unreachable reason. Company profiles, monthly revenue, disclosures and foreign holdings are TWSE main-board only.

Install

Run in a terminal

claude mcp add --transport http taiwan-stocks https://gateway.pipeworx.io/taiwan-stocks/mcp

Add to Settings → Connectors → Add custom connector

https://gateway.pipeworx.io/taiwan-stocks/mcp
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "taiwan-stocks": {
      "url": "https://gateway.pipeworx.io/taiwan-stocks/mcp"
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "taiwan-stocks": {
      "type": "http",
      "url": "https://gateway.pipeworx.io/taiwan-stocks/mcp"
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "taiwan-stocks": {
      "serverUrl": "https://gateway.pipeworx.io/taiwan-stocks/mcp"
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "taiwan-stocks": {
      "type": "http",
      "url": "https://gateway.pipeworx.io/taiwan-stocks/mcp"
    }
  }
}

Using several servers? Build one config file with the MCP config generator.

Configuration

  • PIPEWORX_API_KEYOptional Pipeworx API key. Without it calls are anonymous and capped daily; a free key raises the cap.

Tools this server provides (11)

Taken from the project documentation; the running server may differ.

taiwan_stock_quote
Daily open, high, low, close, change, share volume and TWD turnover.
taiwan_search_securities
Resolve a company name, English abbreviation or code to a listed security.
taiwan_company_profile
Sector, chairman, president, incorporation and listing dates, paid-in capital and shares outstanding for TWSE companies.
taiwan_market_summary
TAIEX and TPEx index levels with market-wide turnover, volume and transaction counts.
taiwan_stock_valuation
P/E, dividend yield and price-to-book as published daily by each exchange.
taiwan_monthly_revenue
Monthly sales with MoM, YoY and year-to-date change, or sector revenue growth ranking.
taiwan_material_news
Mandatory same-day disclosures such as board resolutions, M&A, litigation and capital raises.
taiwan_top_traded
The twenty most heavily traded TWSE securities of the session.
taiwan_foreign_holdings
Foreign and mainland-China ownership by security or sector, with headroom under the statutory ceiling.
taiwan_margin_balance
Margin financing and short-sale balances with the day's activity and quotas.
taiwan_ex_dividend_calendar
Announced ex-dividend and ex-rights dates with cash and stock terms.

What it does

Daily market quotes
Open, high, low, close, change, share volume and TWD turnover for TWSE and TPEx securities.
Valuation metrics
P/E, dividend yield and price-to-book as published daily by each exchange.
Monthly revenue tracking
Monthly sales with month-on-month, year-on-year and year-to-date change for TWSE companies.
Material disclosures
Same-day mandatory filings such as board resolutions, M&A, litigation and capital raises.
Margin and short balances
Margin financing and short-sale balances with the day's activity and quotas.
Ex-dividend calendar
Announced ex-dividend and ex-rights dates with cash and stock terms.

Good for

  • Pulling daily Taiwan stock prices into an agent or dashboard
  • Checking valuation and dividend yield for a Taiwan-listed company
  • Monitoring monthly revenue releases for TWSE-listed firms
  • Scanning same-day corporate disclosures for events affecting a holding
  • Tracking margin balances as a sentiment signal

Pricing

Freemium, from $49 a month

Anonymous 50 calls/day; free account 200 calls/day; paid usage and subscriptions via Pipeworx gateway.

Prices change. Check pipeworx.io before you buy.

Taiwan Stocks FAQ

Does it need an API key?

No. The server is keyless. The README says calls are anonymous and capped at 50 per day, and a free Pipeworx account raises the cap to 200 per day.

How do I refer to a stock?

Every symbol-based tool accepts a numeric code such as 2330, the exchange English abbreviation such as TSMC, or the Chinese name.

Does it cover the OTC board?

Quotes, valuations and margin balances cover both boards. Company profiles, monthly revenue, disclosures, foreign holdings and the ex-dividend calendar are TWSE main-board only.

Is Taiwan Stocks free?

Taiwan Stocks has a free plan, with paid plans for more usage or features. Paid plans start at $49 a month.

How do I add Taiwan Stocks to Claude Code?

Run this command in your terminal: claude mcp add --transport http taiwan-stocks https://gateway.pipeworx.io/taiwan-stocks/mcp

What are the best alternatives to Taiwan Stocks?

The closest alternatives to Taiwan Stocks are Twelvedata, Hk Stocks, Wudao A-Share Stock Data MCP, MCP Stock Analyst and A股数据 API (A-Share Data API).

Where this comes from

  • Description: written from the project's README, the project's website and its MCP Registry entry.
  • Install steps: from the official MCP Registry entry.

How AIPoweredBot checks servers