# TickDB Market Data MCP server > Query real-time and historical market data for forex, metals, indices, US, HK and A-share stocks, crypto and futures. - Listing: https://mcp.tc/i/tickdb-market-data - Connect: use the server's own URL `https://mcp.tickdb.ai/` (with your API key); clients connect to it directly. The listing link is a page, not an MCP endpoint. - Type: remote (Streamable HTTP) - Auth: API key - Category: [Finance & Payments](https://mcp.tc/c/finance-payments) - Vendor: TickDB - Homepage: - Repository: ## About Connects to the TickDB API for real-time quotes, K-line candles, order books, recent trades and intraday data across forex, precious metals, indices, US stocks, Hong Kong stocks, A-shares, cryptocurrencies and China/Hong Kong futures. For supported US, HK and A-share stocks it also returns company profiles, financial statements, valuation, shareholders, dividends, corporate actions, news and event calendars. Runs as a hosted streamable HTTP endpoint at mcp.tickdb.ai. A TickDB API key is required and is sent in the X-TickDB-Key header. A key can be obtained by signing up at tickdb.ai. The server source is MIT licensed on GitHub. ## What it can do - Get real-time price snapshots for up to 50 symbols per request - Fetch historical OHLCV K-line candles with adjustment modes - Read order book depth and recent trades - Look up company profiles, executives and financial statements - Check valuation, industry peers and shareholder data - Browse earnings, dividend, split and IPO calendars - Read company news and article details - Check market status and trading sessions ## Tools (43) - `get_ticker`: Get real-time price snapshots for one or more symbols. - `get_kline`: Get historical OHLCV candles, including futures open interest. - `get_kline_latest`: Get the most recent live K-line candle for one or more symbols. - `get_order_book`: Get bid and ask depth levels for a symbol. - `get_recent_trades`: Get the most recent executed trades for a symbol. - `get_available_symbols`: List supported symbols with pagination. - `get_ex_factors`: Get stock adjustment factors for forward or backward adjustment. - `get_stock_info`: Get fundamental stock info such as shares, EPS, BPS and exchange. - `get_intraday`: Get today's minute-level price data for stocks. - `get_trading_sessions`: Get trading session schedules for stock markets. - `get_trade_days`: Get the trading calendar (trading days and half-days) for a date range. - `get_market_metrics`: Get price, market cap, PE, PB and capital flow metrics for stocks. - `get_capital_flow`: Get capital inflow and outflow by order size for a stock. - `get_company_profile`: Get the current company profile with listing and industry info. - `get_company_executives`: Get current executives, directors and key personnel. - `get_financials_latest`: Get financial rows for up to 20 recent periods. - `get_financials_annual`: Get annual financial metric rows by fiscal year. - `get_financials_ttm`: Get trailing-twelve-month income and cash-flow rows. - `get_segments_latest`: Get the latest business or regional revenue segments. - `get_segments_history`: Get historical business or regional revenue segments. - `get_valuation_latest`: Get current PE with its one-year low, median and high. - `get_valuation_history`: Get historical PE values over time. - `get_industry_peers`: Get industry peers and valuation cross-section for a company. - `get_industry_distribution`: Get industry valuation distribution and sample statistics. - `get_industries_rank`: Get the industry ranking for a market. - `get_industries_tree`: Get an industry's classification and child categories. - `get_dividends`: Get historical and future dividends with pagination. - `get_buyback`: Get company buyback plans, executions and related events. - `get_shareholders_latest`: Get the latest disclosed shareholder structure snapshot. - `get_shareholders_top`: Get major shareholder holdings across reporting periods. - `get_shareholder_detail`: Get holdings and trading details for one shareholder. - `get_fund_holdings_latest`: Get disclosed fund holdings and weights with pagination. - `get_corporate_actions`: Get splits, rights issues, symbol changes and other actions. - `get_company_news`: Get company news titles, summaries and IDs. - `get_dividends_ttm`: Get trailing-12-month cash dividends per share by currency. - `get_news_detail`: Get the article text for a news ID. - `get_market_status`: Get CN, HK and US trading status and market-local time. - `get_report_calendar`: Get earnings and results events with filters and pagination. - `get_dividend_calendar`: Get dividend events with filters and pagination. - `get_split_calendar`: Get split events with date/symbol/market filters and cursor pagination. - `get_ipo_calendar`: Get IPO events with date/symbol/market filters and cursor pagination. - `get_other_calendar`: Get other financial events with date/symbol/market filters and cursor pagination. - `get_api_key_subscriptions`: Query API key subscriptions and expiration information without website login. ## Example prompts - "Get the latest price for AAPL.US, 700.HK and BTCUSDT." - "Show 1h candles for XAUUSD over the last 24 hours." - "What is the PE valuation range for 600519.SH?" - "List upcoming earnings reports for US stocks this week." ## Install ### Claude Code 1. Run this in a terminal, in your project folder: ```bash claude mcp add --transport http tickdb-market-data https://mcp.tickdb.ai/ --header "X-TickDB-Key: " ``` 2. Replace the placeholder with your key before you run it, then check it with `/mcp` inside Claude Code. Add `--scope user` to make it available in every project, not just this one. ### Claude Desktop 1. Use the `mcp-remote` bridge, which keeps the key on this computer (a connector added on claude.ai with the key under **Request headers** also shows up here). Open **Settings → Developer → Edit Config** and add: `claude_desktop_config.json`: ```json { "mcpServers": { "tickdb-market-data": { "command": "npx", "args": [ "-y", "mcp-remote", "https://mcp.tickdb.ai/", "--header", "X-TickDB-Key: " ] } } } ``` 2. Replace the placeholder with your key and restart Claude Desktop. The bridge needs Node.js on your computer. ### claude.ai 1. Open the connector form on claude.ai. This button fills in the name and URL for you: [Add to claude.ai]() (opens connector settings) 2. Check that the URL reads `https://mcp.tickdb.ai/`. Under **Request headers**, add `X-TickDB-Key: ` with your key from TickDB, then click **Add**. 3. Turn it on in a chat from the tools menu. Free plans allow one custom connector. On Team and Enterprise plans an owner adds it under **Organization settings → Connectors**. ### Cursor [Add to Cursor]() (opens Cursor) Or add it by hand to `~/.cursor/mcp.json` (all projects) or `.cursor/mcp.json` (this project): `mcp.json`: ```json { "mcpServers": { "tickdb-market-data": { "url": "https://mcp.tickdb.ai/", "headers": { "X-TickDB-Key": "" } } } } ``` ### VS Code Add it to `.vscode/mcp.json`. VS Code asks for the key the first time and stores it securely: `.vscode/mcp.json`: ```json { "servers": { "tickdb-market-data": { "type": "http", "url": "https://mcp.tickdb.ai/", "headers": { "X-TickDB-Key": "${input:x-tickdb-key}" } } }, "inputs": [ { "type": "promptString", "id": "x-tickdb-key", "description": "X-TickDB-Key", "password": true } ] } ``` ### Devin Desktop 1. Add it to `~/.config/devin/mcp_config.json` (macOS and Linux) or `%APPDATA%\devin\mcp_config.json` (Windows): `mcp_config.json`: ```json { "mcpServers": { "tickdb-market-data": { "serverUrl": "https://mcp.tickdb.ai/", "headers": { "X-TickDB-Key": "" } } } } ``` 2. Refresh the MCP server list in Cascade. Devin Desktop is the new name for Windsurf. It reads `serverUrl` (or `url`) for remote servers. ### Codex ```bash codex mcp add tickdb-market-data --url https://mcp.tickdb.ai/ ``` `codex mcp add` can’t set the `X-TickDB-Key` header, so this step is required: put this entry in `~/.codex/config.toml` instead of running the command, or add its `env_http_headers` line to the entry the command made: `config.toml`: ```toml [mcp_servers.tickdb-market-data] url = "https://mcp.tickdb.ai/" env_http_headers = { "X-TickDB-Key" = "X_TICKDB_KEY" } ``` Codex reads the header values from the environment variables named in `env_http_headers`. ### Gemini CLI ```bash gemini mcp add --transport http --header "X-TickDB-Key: " tickdb-market-data https://mcp.tickdb.ai/ ``` This adds it to the current project. Add `-s user` to use it everywhere. ### Any client Most clients accept this shape. Some name the URL field differently: `serverUrl` in Devin Desktop, `httpUrl` in Gemini CLI’s settings file. ```json { "mcpServers": { "tickdb-market-data": { "type": "http", "url": "https://mcp.tickdb.ai/", "headers": { "X-TickDB-Key": "" } } } } ``` Zed puts servers under `context_servers` in its settings. Cline needs `"type": "streamableHttp"`, or it assumes SSE. Client only starts local servers? Bridge it with `npx -y mcp-remote https://mcp.tickdb.ai/`. ## Recent changes - 2026-10-07 04:20 UTC: Tracking started: 43 tools read. Source: automatic check. More on the History tab, with descriptions before and after for the newest entries: https://mcp.tc/i/tickdb-market-data#history (Atom feed: https://mcp.tc/i/tickdb-market-data/history.xml). It records what mcp.tc's anonymous checks saw, every 3 hours where the tool list can be read without sign-in; it is not a security review. ## Details - Server version: 1.30.0 - MCP protocol version: 2025-11-25 - Last checked: 2026-10-07 (reachable) - Listed: 2026-10-07 - Updated: 2026-10-07 --- Source: https://mcp.tc/i/tickdb-market-data (mcp.tc is an independent directory, not affiliated with this server's publisher). Corrections: https://mcp.tc/report