TWSE

Provides real-time TWSE market data, financial reports, and trading analytics via MCP clients.

typescript

1

GitHub Stars

typescript

Language

4 months ago

First Indexed

2 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "pyang2045-twsemcp": {
      "command": "npx",
      "args": [
        "twse-mcp"
      ]
    }
  }
}

You can access Taiwan Stock Exchange market data, financials, and trading analytics in real time by running an MCP server locally. It connects to the TWSE API and serves data to your MCP client, enabling practical market research, screening, and investing insights right from your environment.

How to use

Run the MCP server locally and connect your MCP client to it to start querying market data, financial reports, and trading insights. You can ask for real-time indices, stock prices, revenue trends, profitability metrics, and investor activity. Use the client’s built‑in tools to pull data by stock or by metric, then combine results to build watchlists, screening rules, and research dashboards.

How to install

Prerequisites: ensure you have Node.js installed on your system.

Option 1: NPX (recommended) Run directly without installation.

npx twse-mcp

Claude Desktop configuration and usage notes

If you want Claude Desktop to use the TWSE MCP server, add a configuration entry for the server in Claude's MCP settings.

{
  "mcpServers": {
    "twse": {
      "command": "npx",
      "args": ["twse-mcp"],
      "env": {}
    }
  }
}

Data sources and update cadence

The server pulls data from the official TWSE OpenAPI with real-time updates during market hours and daily/periodic refreshes for other data categories. Real-time stats are updated at short intervals throughout trading sessions, while financial reports arrive according to their published schedules.

Development and contributing notes

If you want to run the server in development mode, you can install dependencies, build, and start the server locally.

Available tools

getStockDaily

Fetch daily trading data including prices, volumes, and OHLC for all stocks.

getStockPERatios

Provide valuation metrics such as P/E ratios and related indicators.

getMarketIndex

Return market indices like TAIEX and sector indices with real-time updates.

getStockDayAvg

Compare daily closing prices against monthly averages.

getMonthlyStats

Deliver monthly trading statistics including highs and lows.

searchStock

Search data for a specific stock by code or name.

getMonthlyRevenue

Provide monthly revenue reports for companies.

getIncomeStatement

Return quarterly income statements.

getBalanceSheet

Return quarterly balance sheets.

getIndustryEPS

Provide EPS data by industry.

getProfitAnalysis

Show profitability metrics such as ROE, ROA, and margins.

searchFinancials

Search financials for a specific company.

getTop20Volume

List the most traded stocks by volume.

getMarginTrading

Provide margin trading and leverage data.

getFiveSecondStats

Offer real-time bid/ask statistics.

getTopForeignHoldings

Show top foreign holdings by company.

getForeignCategoryHoldings

Break down foreign investments by sector.

getNewListings

Show recent IPO listings.

getSuspendedListings

Identify delisted companies.

getETFRanking

Rank ETFs by popularity or other metrics.

getIndexHistory

Provide historical index data.

getHolidaySchedule

Display market calendar and holidays.