MCP Catalogs
HomeTWSEMCPServer screenshot

TWSEMCPServer

by twjackysu·90·Score 48

Comprehensive MCP server for Taiwan stock market data with real-time quotes and financial analysis.

financeai-llmdeveloper-tools
32
Forks
1
Open issues
this month
Last commit
2d ago
Indexed

Overview

TWStockMCPServer is a comprehensive Model Context Protocol server designed for Taiwan stock market data analysis. It integrates multiple financial APIs including TWSE (Taiwan Stock Exchange), TPEx (Taiwan OTC Exchange), and TAIFEX (Taiwan Futures Exchange). The server provides real-time stock information, financial statements, ESG data, and trend analysis tools. It offers five major investment analysis scenarios including individual stock trend analysis, foreign investment interpretation, market hotspot capture, dividend investment planning, and investment screening.

Try asking AI

After installing, here are 7 things you can ask your AI assistant:

you:Analyze stock trends of specific Taiwan companies
you:Track foreign investment patterns in Taiwan markets
you:Identify high-dividend stocks and upcoming ex-dividend dates
you:Monitor market hotspots and unusual trading volumes
you:Screen value stocks with good ESG performance
you:What APIs does this MCP server integrate?
you:How can I use this MCP server?

When to choose this

Choose this server if you need comprehensive Taiwan stock market data with real-time quotes and financial analysis tools integrated through MCP.

When NOT to choose this

Don't choose this if you need data for markets outside Taiwan, or if you require write access to financial systems (this is a read-only data source).

Tools this server exposes

12 tools extracted from the README
  • get_stock_daily_info

    Get daily trading information for a specific stock

  • get_stock_monthly_avg

    Get monthly average prices for a stock

  • get_three_major_trades

    Get three major investors' buying and selling data

  • get_eshg_data

    Get ESG (Environmental, Social, Governance) data for companies

  • get_financial_statements

    Get financial statements of a company

  • get_dividend_info

    Get dividend information and ex-dividend dates

  • get_stock_index

    Get Taiwan stock market index data

  • get_otc_trading_info

    Get trading information for OTC (over-the-counter) stocks

  • get_realtime_quotes

    Get real-time stock quotes during market hours

  • get_futures_data

    Get futures market data from Taiwan Futures Exchange

  • get_stock_valuation

    Get stock valuation metrics and ratios

  • get_margin_trading_info

    Get margin trading information for stocks

Note: Tool names inferred from data sources section and feature descriptions rather than explicit tool documentation

Comparable tools

twse-data-apistock-analysis-apifinancial-data-mcp

Installation

Installation

Online Usage (Recommended)

{
  "twstockmcpserver": {
    "transport": "streamable_http",
    "url": "https://TW-Stock-MCP-Server.fastmcp.app/mcp"
  }
}

Docker Usage (stdio, no self-hosting)

{
  "twstockmcpserver": {
    "command": "docker",
    "args": [
      "run",
      "-i",
      "--rm",
      "--pull=always",
      "-e",
      "MCP_STDIO=1",
      "ghcr.io/twjackysu/twsemcpserver:latest"
    ]
  }
}

Docker Usage (HTTP, self-hosting)

docker run -d -p 8000:8000 -e PORT=8000 ghcr.io/twjackysu/twsemcpserver:latest

Local Installation

git clone https://github.com/twjackysu/TWStockMCPServer.git
cd TWStockMCPServer
uv sync && uv run fastmcp dev server.py

Claude Desktop Configuration

Add to config.json:

{
  "mcpServers": {
    "twstockmcpserver": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "--pull=always",
        "-e",
        "MCP_STDIO=1",
        "ghcr.io/twjackysu/twsemcpserver:latest"
      ]
    }
  }
}

FAQ

What APIs does this MCP server integrate?
The server integrates Taiwan Stock Exchange (TWSE) OpenAPI, TWSE Web API, MIS real-time quotes, TPEx OpenAPI, and TAIFEX OpenAPI, providing over 168 tools for market data analysis.
How can I use this MCP server?
You can use it online via the provided URL, with Docker using either stdio or HTTP transport, or install it locally using Python with uv package manager.

Compare TWSEMCPServer with

GitHub →

Last updated · Auto-generated from public README + GitHub signals.