TWStock

TWStockMCPServer is a model context protocol (MCP) server designed to provide real-time stock data, financial statements, ESG data, and trend analysis for Taiwan's stock market. You can access up-to-date market insights through MCP clients to power your analyses, dashboards, and automation workflows.

How to use

You connect to TWStockMCPServer using an MCP client to fetch real-time stock information, financials, ESG data, and trend analyses. Use the online service for quick access or run a local server to tailor the setup to your environment. When you connect, you can request stock-specific trend insights, investor activity, market hotspots, dividend calendars, and screening for potential investment targets.

How to install

Prerequisites: ensure you have a modern runtime installed on your system. You will need a compatible MCP runner (such as UVX) to start and manage MCP servers.

Online configuration (recommended): use the provided MCP URL in your MCP client configuration.

Local installation steps: follow these commands to clone the repository and run the server locally.

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

Additional notes

The server supports an online MCP URL for quick connections and a local runtime via UVX for development and customization. The example shown demonstrates how you can configure an MCP client to reach the online service.