# tw-market-data MCP server

Taiwan stock market data (TWMD): official-source, point-in-time-safe datasets via read-only tools.

## Links
- Registry page: https://www.getdrio.com/mcp/com-twmarketdata-tw-market-data
- Website: https://twmarketdata.com

## Install
- Endpoint: https://mcp.twmarketdata.com/mcp
- Auth: Auth required by registry metadata

## Setup notes
- Remote header: X-API-Key (required; secret)
- The upstream registry signals required auth or secrets.
- Remote endpoint: https://mcp.twmarketdata.com/mcp
- Header: X-API-Key

## Tools
- list_datasets - List available Taiwan-market datasets (discovery entry point). Returns id / 中文名 /
    category / tier / one-line description for each. Use this first to find the right data.

    Args:
        category: optional, e.g. 'chip'(籌碼) 'fundamental'(基本面) 'price'(行情) 'macro'(總經)
                  'relation'(關聯/產業鏈) 'derivatives'(期權) 'event'(事件) 'rag_text'(文本).
        tier: optional minimum plan: 'free' 'starter' 'pro' 'max' 'developer' 'enterprise'.
     Endpoint: https://mcp.twmarketdata.com/mcp
- describe_dataset - FULL semantics of one dataset: grain (what a row is), field meanings+units, ★TIME-CORRECTNESS
    rules (knowledge_time_field / point_in_time_safe — read before backtesting), relations for
    cross-table reasoning, agent_hints (when to use), quant_use (which factors). Args: dataset_id. Endpoint: https://mcp.twmarketdata.com/mcp
- query_dataset - Query rows with built-in look-ahead protection.

    ★ POINT-IN-TIME: pass `as_of` (YYYY-MM-DD) for backtesting/agent-learning. For non-point-in-time-safe
    datasets (fundamentals, monthly_revenue, dividend_policy…) rows are filtered by DISCLOSURE date <= as_of,
    so the agent only sees what was public at that moment. Omit as_of only for present-day lookups (warned).

    Args:
        dataset_id: see list_datasets. tickers: e.g. ['2330','2317']. start/end: 'YYYY-MM-DD' range.
        as_of: knowledge-time cutoff 'YYYY-MM-DD' (use for backtests). limit: <=5000.
    Returns: {meta:{table,coverage,row_count,as_of_applied,point_in_time_safe,warnings}, data:[...]}
    Example: query_dataset('fundamental_income', tickers=['2330'], as_of='2023-06-30')
     Endpoint: https://mcp.twmarketdata.com/mcp
- find_related - Traverse the knowledge graph for cross-table / supply-chain reasoning.
    - dataset_id: returns join-able datasets (+why) to plan multi-table analysis.
    - ticker: returns its industry value-chain node + peers in the same node (supply-chain reasoning).
    Args: dataset_id (e.g. 'equity_daily_prices') and/or ticker (e.g. '2330').
     Endpoint: https://mcp.twmarketdata.com/mcp

## Resources
Not captured

## Prompts
Not captured

## Metadata
- Owner: com.twmarketdata
- Version: 1.28.1
- Runtime: Streamable Http
- Transports: HTTP
- License: Not captured
- Language: Not captured
- Stars: Not captured
- Updated: Jul 22, 2026
- Source: https://registry.modelcontextprotocol.io