PlugWiki
TickDB logo

TickDB MCP Server: Setup for Claude, Cursor and Other Apps

OfficialRemoteLocal

Lets Claude, Cursor and other AI apps look up live and historical prices, order books and company financials for stocks, forex, crypto and futures.

This is TickDB's own server for its market data API. It covers forex, metals, indices, US, Hong Kong and China A-shares, China and Hong Kong futures and crypto, plus company financials for US, HK and China A-shares. Connect to the hosted address with your TickDB API key, or sign in through OAuth in ChatGPT and Claude.

You need a TickDB account and key, and the data you can reach depends on the key's plan. Every tool only reads data.

Good for

  • Traders and analysts who want market data inside a chat
  • Investors checking financials, dividends and shareholders of US, HK and China A-share companies
  • Developers building trading or research agents on TickDB data

Works in

14 should work

Tap an app to see how to set it up and any known problems.

Install TickDB MCP

Claude Code

  1. 1

    Copy this prompt.

    Add the TickDB MCP server to Claude Code. Open .mcp.json (create it if it does not exist) and merge in this entry, keeping any servers already there:
    
    {
      "mcpServers": {
        "tickdb": {
          "type": "http",
          "url": "https://mcp.tickdb.ai/",
          "headers": {
            "X-TickDB-Key": "YOUR_TICKDB_API_KEY"
          }
        }
      }
    }
    
    Then tell me how to load it and whether I need to sign in.
  2. 2

    Paste it into Claude Code. It shows the change and asks before running it.

Requires TickDB API key.

You need a TickDB API key from tickdb.ai. The hosted address takes the key in the X-TickDB-Key header. Data you can see depends on your key's plan.

From the project README. Source.

Tools

  • Live price snapshot for a symbol

    Returns the current quote for one or more symbols, up to 50 at a time. It covers forex, metals, indices, US, HK and China A-shares, futures and crypto.

    Try: “What is the live price of AAPL.US and 700.HK?”

    Network · get_ticker

  • Historical candles (open, high, low, close, volume)

    Returns past candles from 1 minute to 1 month. For stocks you can choose no adjustment, forward or backward adjustment. The last candle may still be forming.

    Try: “Show daily candles for 600519.SH over the last 3 months, forward adjusted.”

    Network · get_kline

  • Latest candle, even if still forming

    Returns the current candle that has not closed yet, for up to 50 symbols. Stocks can be adjusted.

    Try: “What is today's 5-minute candle for TSLA.US so far?”

    Network · get_kline_latest

  • Buy and sell order depth

    Returns the order book with bids and asks at several price levels. It works for US, HK and China stocks, China and HK futures and crypto.

    Try: “Show the order book for BTCUSDT.”

    Network · get_order_book

  • Latest individual trades

    Returns recent trade-by-trade records, 100 by default and up to 1000. It works for stocks, futures and crypto.

    Try: “Show the last 50 trades on ETHUSDT.”

    Network · get_recent_trades

  • Lists symbols you can query

    Lists the symbols TickDB supports by type, including China and HK futures contracts, with paging.

    Try: “Which futures symbols are available?”

    Network · get_available_symbols

  • Price adjustment factors for stocks

    Returns the forward and backward adjustment factors for US, HK and China A-share stocks, so you can reconcile adjusted and raw prices.

    Try: “Give me the adjustment factors for 700.HK.”

    Network · get_ex_factors

  • Basic facts about stocks

    Returns basic stock facts such as earnings per share, book value per share and dividend yield for up to 500 symbols at once.

    Try: “What are the EPS and dividend yield of AAPL.US and MSFT.US?”

    Network · get_stock_info

  • Minute-by-minute prices for today

    Returns today's intraday price series for up to 50 US, HK or China stocks.

    Try: “Show today's intraday chart data for 9988.HK.”

    Network · get_intraday

  • Market opening hours

    Returns trading sessions for one stock market or all of them, in each market's local time.

    Try: “When does the Hong Kong market open and close?”

    Network · get_trading_sessions

  • Trading calendar

    Returns the trading days of a stock market. A single request spans at most 31 days and must start within the last year.

    Try: “Which days is the US market open next month?”

    Network · get_trade_days

  • Valuation and market indicators

    Returns indicators such as PE, PB, market value and fund flow for US, HK and China stocks.

    Try: “What are the PE and market cap of 000858.SZ?”

    Network · get_market_metrics

Read from the source code

Permissions

low risk · 2 things to watch

Low risk

All 43 tools only read market data and never trade or change anything. Your TickDB API key is the only secret, so keep it out of shared files.

What it can do

  • Read your data
  • Create and change things
  • Delete things
  • Read-only mode

Watch out for

  • Your API key lives in your client config

    The header setup puts your TickDB key in a config file or command. Keep that file out of Git and shared screenshots. github.com

  • OAuth stores your key on the server

    The OAuth route saves an encrypted binding of your API key on TickDB's server so calls and refresh keep working. Use the header route if you prefer it not stored. github.com

Security advisories

No published security advisories as of Nov 1, 2026.

Technical details
Talks tomcp.tickdb.ai and the TickDB REST API
Sign-in and keysWith the header route the key stays in your client config and is not stored by the server. With OAuth the server stores the key binding encrypted.
Scopes
  • Your TickDB API key (OAuth scope tickdb:read)

Questions

Is the TickDB MCP server official?

Yes. It is published by TickDB for its own market data API, in the TickDB GitHub organization.

What is the TickDB MCP server URL?

https://mcp.tickdb.ai/ for apps that send an API key header. ChatGPT and Claude on the web use https://mcp.tickdb.ai/oauth instead and sign in with OAuth.

Do I need a TickDB API key?

Yes. Get one at tickdb.ai. Which markets and fundamentals you can reach depends on your key's plan.

Can it place trades?

No. All 43 tools read data: quotes, candles, order books, financials and calendars. There are no order or account-changing tools.

Can I run it myself?

Yes. The repo includes a Python server and a Docker build that you can run locally or on your own domain. It listens on all network interfaces by default, so set an access token if you expose it.

Which markets does it cover?

Prices cover forex, precious metals, indices, US, Hong Kong and China A-shares, China and Hong Kong futures and crypto. Company financials cover US, Hong Kong and China A-shares.

Information

updated Nov 2, 2026

Publisher
Official
Endpoint
https://mcp.tickdb.ai
Transport
Streamable HTTP, stdio
Auth
API key
Version
0.1.2
License
MIT
Last commit
Oct 14, 2026
Open issues
2
Listed in
Official MCP registry

WebsiteGitHubOfficial MCP RegistryChangelogIssues

Sources

Docs, issue trackers and discussions this page is built from. Issues, quotes and findings above link to their own source.

Show all 3
  1. github.com · github.com
  2. github.com · github.com
  3. github.com · github.com

Facts from the official MCP registry, GitHub, npm, PyPI and the Docker catalog. Updated Nov 2, 2026.