# Taiwan Stocks

> Taiwan Stocks is a freemium MCP server for finance and payments. Keyless MCP server for Taiwan-listed stock prices, valuations, filings and dividend dates. It can run locally on your machine or as a hosted remote server.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Starting price:** $49 a month
- **Platforms:** API, CLI, self-hosted
- **Website:** https://pipeworx.io/packs/taiwan-stocks
- **Repository:** https://github.com/pipeworx-io/mcp-taiwan-stocks
- **MCP Registry name:** io.github.pipeworx-io/taiwan-stocks
- **Categories:** [finance and payments](https://ai-powered.com/categories/finance-and-payments)
- **Listing updated:** 2026-11-18

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

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

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://gateway.pipeworx.io/taiwan-stocks/mcp
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "taiwan-stocks": {
      "url": "https://gateway.pipeworx.io/taiwan-stocks/mcp"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

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

### Windsurf (~/.codeium/windsurf/mcp_config.json)

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

### Other clients (your client's MCP settings (most use this shape))

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

## Tools

- `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.

## 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.

## Alternatives

- [Twelvedata](https://ai-powered.com/mcp/twelvedata): Twelvedata is a freemium MCP server for finance and payments.
- [Hk Stocks](https://ai-powered.com/mcp/hk-stocks): Hk Stocks is a freemium MCP server for finance and payments.
- [Wudao A-Share Stock Data MCP](https://ai-powered.com/mcp/wudao-a-share-stock-data-mcp): Wudao A-Share Stock Data MCP is a freemium MCP server for finance and payments.
- [MCP Stock Analyst](https://ai-powered.com/mcp/mcp-stock-analyst): MCP Stock Analyst is a freemium MCP server for finance and payments.
- [A股数据 API (A-Share Data API)](https://ai-powered.com/mcp/a-api-a-share-data-api): A股数据 API (A-Share Data API) is a freemium MCP server for finance and payments.
- [stocks-llm](https://ai-powered.com/mcp/stocks-llm): stocks-llm is a free MCP server for finance and payments.
- [AlphaPrime Stocks](https://ai-powered.com/mcp/alphaprime-stocks): AlphaPrime Stocks is a freemium MCP server for finance and payments.
- [Korea Stock MCP](https://ai-powered.com/mcp/korea-stock-mcp): Korea Stock MCP is an open-source MCP server for finance and payments.

---
Source: https://ai-powered.com/mcp/taiwan-stocks
