Taiwan Stock Exchange
Provides real-time access to Taiwan Stock Exchange market data, financial reports, and trading analytics. It enables users to query stock prices, market indices, and corporate profitability metrics through natural language.
What is Taiwan Stock Exchange?
Taiwan Stock Exchange is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to provides real-time access to taiwan stock exchange market data, financial reports, and trading analytics. it enables users to query stock prices, market indices, and corporate profitability metrics th...
Provides real-time access to Taiwan Stock Exchange market data, financial reports, and trading analytics. It enables users to query stock prices, market indices, and corporate profitability metrics through natural language.
This server falls under the Finance & Fintech category on MCPgee, the world's largest MCP server directory with 33,000+ servers.
Features
- Provides real-time access to Taiwan Stock Exchange market da
Use Cases
Maintainer
Works with
Installation
Manual Installation
npx twse-mcp-serverConfiguration
Configuration Details
claude_desktop_config.json
Performance
Response Metrics
Resource Usage
How to Set Up and Use Taiwan Stock Exchange
TWSE MCP Server connects AI assistants to the Taiwan Stock Exchange, providing access to over 169 tools spanning real-time quotes, financial statements, ESG data, margin trading, institutional investor activity, and futures/options from TAIFEX. It pulls data from TWSE OpenAPI, TWSE Web API, MIS real-time quotes, TPEx OTC market, and TAIFEX derivatives — giving analysts a single natural-language interface to query Taiwanese equities in depth. Whether you need intraday pricing for a single stock or want to screen for high-dividend or undervalued names, this server turns conversational prompts into structured market queries.
Prerequisites
- Docker Desktop installed (for the recommended Docker deployment method)
- An MCP-compatible client such as Claude Desktop
- Internet access to reach the TWSE/TAIFEX public APIs (no API key required for most data)
- Alternatively, Node.js 18+ if using the HTTP transport option pointing to the hosted endpoint
Choose your deployment mode
The server supports three deployment modes: (1) Online HTTP transport pointing to the hosted endpoint at https://TW-Stock-MCP-Server.fastmcp.app/mcp — zero local setup required. (2) Docker stdio mode for local offline use. (3) Local Python source via uv. The hosted HTTP option is recommended for most users.
Configure Claude Desktop for the hosted HTTP endpoint
Edit your Claude Desktop configuration file (claude_desktop_config.json) to add the server using streamable HTTP transport. This requires no local installation — the server runs in the cloud.
{
"mcpServers": {
"twse": {
"transport": "streamable_http",
"url": "https://TW-Stock-MCP-Server.fastmcp.app/mcp"
}
}
}Alternatively, run via Docker (stdio mode)
If you prefer a fully local deployment without relying on the hosted service, use the pre-built Docker image. This runs the server in stdio mode, which Claude Desktop launches automatically.
docker pull ghcr.io/twjackysu/twsemcpserver:latest
# Then add to claude_desktop_config.json:
{
"mcpServers": {
"twse": {
"command": "docker",
"args": ["run", "-i", "--rm", "--pull=always", "-e", "MCP_STDIO=1", "ghcr.io/twjackysu/twsemcpserver:latest"]
}
}
}Restart Claude Desktop
After saving your configuration file, fully quit and relaunch Claude Desktop. The TWSE tools will appear in the tool list. You can verify by asking Claude to list available TWSE tools.
Run a test query
Try a simple query to confirm the server is working. TWSE stock symbols are numeric (e.g., 2330 for TSMC). The server handles both Chinese and English prompts.
Taiwan Stock Exchange Examples
Client configuration (Docker stdio)
Claude Desktop config using Docker for local stdio transport — no environment variables required as the server uses public TWSE APIs.
{
"mcpServers": {
"twse": {
"command": "docker",
"args": [
"run", "-i", "--rm", "--pull=always",
"-e", "MCP_STDIO=1",
"ghcr.io/twjackysu/twsemcpserver:latest"
]
}
}
}Prompts to try
These prompts leverage the server's 169+ tools across TWSE, TPEx, and TAIFEX data sources.
- "Analyze the recent price trend of TSMC (stock code 2330)"
- "What stocks have foreign institutional investors been buying this week?"
- "Show me high-dividend yield stocks listed on TWSE"
- "Get the current intraday price and volume for stocks 2330, 2317, and 2454"
- "What are the latest futures positions for large traders on TAIFEX?"Troubleshooting Taiwan Stock Exchange
Docker command not found or image fails to pull
Ensure Docker Desktop is running before launching Claude Desktop. Run 'docker pull ghcr.io/twjackysu/twsemcpserver:latest' manually to pre-cache the image and verify your Docker installation.
Tools appear but return empty results or errors
TWSE APIs are only available during market hours (weekdays, Taiwan time UTC+8). Some endpoints for financial reports may have a one-day delay. Verify connectivity to twse.com.tw from your network.
HTTP transport endpoint is unreachable
The hosted endpoint at TW-Stock-MCP-Server.fastmcp.app is community-maintained. If it is unavailable, fall back to the Docker stdio deployment for a fully self-contained local setup.
Frequently Asked Questions about Taiwan Stock Exchange
What is Taiwan Stock Exchange?
Taiwan Stock Exchange is a Model Context Protocol (MCP) server that provides real-time access to taiwan stock exchange market data, financial reports, and trading analytics. it enables users to query stock prices, market indices, and corporate profitability metrics through natural language. It connects AI assistants to external tools and data sources through a standardized interface.
How do I install Taiwan Stock Exchange?
Follow the installation instructions on the Taiwan Stock Exchange GitHub repository. Clone the repo, install dependencies, and add the server config to your AI client.
Which AI clients work with Taiwan Stock Exchange?
Taiwan Stock Exchange works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.
Is Taiwan Stock Exchange free to use?
Yes, Taiwan Stock Exchange is open source and available under the MIT License license. You can use it freely in both personal and commercial projects.
Taiwan Stock Exchange Alternatives — Similar Finance & Fintech Servers
Looking for alternatives to Taiwan Stock Exchange? Here are other popular finance & fintech servers you can use with Claude, Cursor, and VS Code.
ValueCell
★ 10.7kValueCell is a community-driven, multi-agent platform for financial applications.
Vibe Trading
★ 8.1k'Vibe-Trading: Your Personal Trading Agent'
Quantdinger
★ 6.2kAI quantitative trading platform for crypto, stocks, and forex with backtesting, live trading, market data, and multi-agent research.vibe-trading ,trading-agents,ai-trader,ai-trading
TradingView
★ 2.8kReal-time crypto & stock screening, advanced technical indicators, Bollinger Bands intelligence, candlestick patterns + native Claude Desktop integration. Multi-exchange (Binance, KuCoin, Bybit+). Open-source AI trading infrastructure.
Financial Datasets
★ 2.1kProvides access to comprehensive financial data including income statements, balance sheets, cash flow statements, stock prices, company news, SEC filings, and cryptocurrency information with built-in financial ratio analysis.
Stripe
★ 1.6kThe Stripe Model Context Protocol server allows you to integrate with Stripe APIs through function calling. This protocol supports various tools to interact with different Stripe services.
Browse More Finance & Fintech MCP Servers
Explore all finance & fintech servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.
Set Up Taiwan Stock Exchange in Your Editor
Choose your AI client for step-by-step setup instructions.
Quick Config Preview
Add this to your claude_desktop_config.json or .cursor/mcp.json
Ready to use Taiwan Stock Exchange?
Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.