
TickDB MCP Server: Setup for Claude, Cursor and Other Apps
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.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports hosted MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports hosted MCP servers.
Install TickDB MCP
Claude Code
- 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
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_tickerHistorical 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_klineLatest 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_latestBuy 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_bookLatest 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_tradesLists 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_symbolsPrice 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_factorsBasic 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_infoMinute-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_intradayMarket 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_sessionsTrading 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_daysValuation 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_metricsMoney flow by order size
Returns inflow and outflow split into large, medium and small orders for a stock.
Try: “Show capital flow for 600519.SH today.”
Network ·
get_capital_flowCompany overview
Returns the company profile for a US, HK or China stock, such as what it does and basic corporate details.
Try: “Give me a profile of NVDA.US.”
Network ·
get_company_profileCompany leadership
Returns the executives and key people listed for a company.
Try: “Who are the executives of 9988.HK?”
Network ·
get_company_executivesMost recent financial statements
Returns the latest income statement, balance sheet or cash flow statement for a company.
Try: “Show Apple's latest income statement.”
Network ·
get_financials_latestAnnual financial statements
Returns yearly income, balance sheet or cash flow records for a company.
Try: “Show Tesla's annual cash flow statements.”
Network ·
get_financials_annualTrailing twelve months figures
Returns trailing-twelve-month figures for the income statement or cash flow statement.
Try: “What is Microsoft's trailing twelve month income?”
Network ·
get_financials_ttmLatest revenue by business segment
Returns the most recent breakdown of a company's results by business segment.
Try: “How does Alibaba split its latest revenue by segment?”
Network ·
get_segments_latestSegment results over time
Returns the history of a company's business segment results across reporting periods.
Try: “Show how Amazon's segments changed over the past years.”
Network ·
get_segments_historyCurrent valuation
Returns the current valuation of a company. At the moment it returns PE.
Try: “What is Nvidia's current PE?”
Network ·
get_valuation_latestValuation over time
Returns how a company's valuation has moved over time. At the moment it returns PE.
Try: “Show Meta's PE history for the past years.”
Network ·
get_valuation_historyCompanies in the same industry
Returns peer companies in the same industry as a given stock.
Try: “Who are Tesla's industry peers?”
Network ·
get_industry_peersHow an industry is spread out
Returns the distribution of companies across an industry.
Try: “Show how the semiconductor industry is distributed.”
Network ·
get_industry_distributionIndustries ranked
Returns a ranking of industries.
Try: “Rank the industries in the US market.”
Network ·
get_industries_rankIndustry classification tree
Returns the industry hierarchy so you can see which sectors and sub-industries exist.
Try: “Show the industry tree for the HK market.”
Network ·
get_industries_treeDividend history
Returns dividend records for a company, with cursor paging.
Try: “Show Coca-Cola's recent dividends.”
Network ·
get_dividendsDividends over the last twelve months
Returns the trailing twelve month dividend total for a company.
Try: “What did Apple pay in dividends over the last twelve months?”
Network ·
get_dividends_ttmShare buybacks
Returns share repurchase records for a company.
Try: “Has 700.HK bought back shares recently?”
Network ·
get_buybackSplits, dividends and other actions
Returns corporate actions for a company, such as splits and capital changes.
Try: “List the recent corporate actions for NVDA.US.”
Network ·
get_corporate_actionsLatest shareholder breakdown
Returns the latest shareholder summary for a company.
Try: “Who owns Tesla right now?”
Network ·
get_shareholders_latestLargest shareholders
Returns the top shareholders of a company.
Try: “List the top shareholders of 600519.SH.”
Network ·
get_shareholders_topDetail on one shareholder
Returns details about a single shareholder's position in a company.
Try: “Show the stake details for the largest holder of AAPL.US.”
Network ·
get_shareholder_detailFunds that hold a stock
Returns the latest fund holdings of a stock, with cursor paging.
Try: “Which funds hold Microsoft?”
Network ·
get_fund_holdings_latestCompany news headlines
Returns recent news for a company.
Try: “What is the latest news on Tesla?”
Network ·
get_company_newsFull text of one news item
Returns the details of a single news item by its ID.
Try: “Open the news item you just found and summarize it.”
Network ·
get_news_detailWhether markets are open
Returns the current status of a stock market, such as open or closed.
Try: “Is the US market open right now?”
Network ·
get_market_statusUpcoming earnings reports
Returns the calendar of company earnings report dates, with cursor paging.
Try: “Which companies report earnings next week?”
Network ·
get_report_calendarUpcoming dividend dates
Returns the calendar of dividend dates, with cursor paging.
Try: “Which stocks go ex-dividend this week?”
Network ·
get_dividend_calendarUpcoming stock splits
Returns the calendar of stock splits, with cursor paging.
Try: “Any stock splits scheduled this month?”
Network ·
get_split_calendarUpcoming IPOs
Returns the calendar of IPOs, with cursor paging.
Try: “What IPOs are coming up?”
Network ·
get_ipo_calendarOther market events by category
Returns a calendar of other event types. You must pass a category.
Try: “Show the other calendar events for next week.”
Network ·
get_other_calendarYour TickDB plan and expiry
Looks up the plan, status and expiry of the API key you connected, without logging in to the TickDB site.
Try: “When does my TickDB plan expire?”
Network ·
get_api_key_subscriptions
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 to | mcp.tickdb.ai and the TickDB REST API |
|---|---|
| Sign-in and keys | With 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 |
|
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
Sources
Docs, issue trackers and discussions this page is built from. Issues, quotes and findings above link to their own source.
Show all 3Hide
- github.com · github.com
- github.com · github.com
- github.com · github.com