Tools / MCP

文件入口#

你可以從左側導覽查看所有 API 文件，也可以從 Quick Start 建立第一個 request。

後續若要讓 agent 或內部工具讀取文件，可透過 OpenAPI spec、llms.txt 或 MCP tools 作為入口。

目前 Tools / MCP 採 preview / controlled rollout 語義，正式可用範圍會依帳號方案與 API key 權限決定。

Overview#

TW Market Data 的 Tools / MCP 目標，是讓 AI agent、研究流程與內部資料產品可以透過穩定工具介面查詢台股資料。

這些工具會包裝底層 dataset API，例如行情、月營收、財報、估值、技術指標、籌碼與公司事件。

前端文件可以先展示工具設計與預期用法；正式 MCP server endpoint 仍以 controlled rollout 與帳號權限為準。

Authentication#

Tools / MCP 建議同時理解 API key 與互動式 connector 兩種接入方向。

API Key：用於 programmatic access。正式 request 使用 X-API-Key header。

OAuth / hosted connector：可作為未來 interactive client 的接入方向，例如 Cursor、Claude、內部 agent console；目前以 rollout 狀態為準。

若還沒有帳號，先前往儀表板建立 API key。API key 權限會限制可查詢 dataset、rate limit 與 monthly usage。

Getting Started#

以下示例用於展示 Tools / MCP 的預期接入方式；是否可直接連線，需依目前帳號權限與 rollout 狀態判斷。

Internal agent workflow 建議採以下步驟：agent 先選工具、工具轉成 dataset query、回傳 normalized JSON，最後由 agent 進行摘要、篩選或比對。流程中不應直接讀 raw payload 或私有 token。

• Cursor / IDE agent
• Python client
• Internal agent workflow

# Cursor / IDE agent (sample config){  "mcpServers": {    "tw-market-data": {      "url": "https://mcp.twmarketdata.com/"    }  }} Note:- URL 為未來正式 MCP endpoint 範例，實際部署位址以帳號後台或內部部署設定為準。- 若尚未開放 MCP server，可先用 REST API 或 OpenAPI spec。

import asynciofrom mcp import ClientSessionfrom mcp.client.streamable_http import streamablehttp_client API_KEY = "your_api_key_here"SERVER_URL = "https://mcp.twmarketdata.com/api" async def main():    async with streamablehttp_client(        SERVER_URL,        headers={"X-API-Key": API_KEY},    ) as streams:        read_stream, write_stream, _ = streams        async with ClientSession(read_stream, write_stream) as session:            await session.initialize()            result = await session.call_tool(                "get_twse_daily_price",                {"symbol": "2330", "limit": 5},            )            print(result.content) asyncio.run(main())

MCP Tools#

下列工具清單以目前台股資料能力為基礎，並區分正式能力與 preview。

• Market Prices：get_twse_daily_price、get_tpex_daily_price、get_adjusted_prices、get_market_indices、get_market_breadth
• Financials：get_monthly_revenue、get_income_statement、get_balance_sheet、get_cash_flow_statement、get_valuation_data
• Capital Flow：get_institutional_flow、get_margin_short
• Company & Events：get_issuer_profile、get_issuer_announcements、get_events、get_structured_events、get_dividends、get_corporate_actions
• Classification & Strategy：get_theme_taxonomy、get_index_classification、get_factor_data、screen_taiwan_stocks、list_screener_fields
• Preview：get_company_news、get_market_news