futu-opend-mcp
This MCP server provides read-only access to 50+ Futu OpenD investment research and market data tools, covering stocks, options, financials, and macro analysis. Trading and subscriptions are not supported.
Price & Market Data
Real-time snapshots (price, OHLC, volume, bid/ask), historical K-line/candlestick data, market state (open/closed/lunch break), and basic stock info.
Search & Screening
Search securities/ETFs/plates by keyword, search news/announcements/analyst ratings, and multi-factor stock screening.
Financials & Valuation
Financial statements (income, balance sheet, cash flow, key metrics), revenue breakdowns, earnings calendar, earnings-day price/IV history, analyst consensus, Morningstar reports, PE/PB/PS valuation trends, and operational efficiency metrics.
Corporate Actions & Shareholders
Dividends, buybacks, splits, shareholder structure, holding changes, top-10 holders, institutional holdings by stock, and US insider/Form 4 data.
Company Profile
Company overview, executive team, and individual executive career backgrounds.
Capital Flow & Short Data
Main-force capital in/out time series, order-size distribution (super/big/mid/small), top-10 brokers (HK only), and short volume/interest/days-to-cover.
Options
Resolve option codes, full option chains, expiration dates, real-time quotes/Greeks, IV/HV analysis, combo strategy P&L/breakeven analysis, and underlying IV/HV/OI/PCR statistics.
Warrants & Futures
List warrants/CBBCs for an underlying, futures contract details (size, last trade day, sessions), and find related securities.
Plates & Industrial Chains
List concept/industry/region plates, plate constituents, plates a stock belongs to, and upstream/midstream/downstream industrial chain browsing.
Institutions
List/search institutions, institution profiles, stocks held by an institution, holding changes, and industry distribution of holdings.
Macro & Economic
Economic event calendar, macro indicator time series, and CME FedWatch rate probabilities/dot plots.
Dividends & IPO
Forward all-market dividend/ex-date calendar and upcoming/recent IPO lists.
Diagnostics
Check user permissions, K-line quota, subscription limits, and login status.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@futu-opend-mcp show me the latest price for AAPL"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
futu-opend-mcp
An MCP server that exposes Futu OpenD's read-only investment-research quote APIs (stock/option/warrant/futures prices, financials, news/announcements, shareholders, institutions, macro) as MCP tools. It borrows your already-running, logged-in Futu OpenD gateway - no separate auth. No trading, no subscriptions.
It wraps the official Futu skill pack unmodified, so it stays in sync with Futu's own field-parsing logic.
Install & run
Claude Code / Claude Desktop (stdio)
claude mcp add futu-opend-mcp -- uvx futu-opend-mcpOr from git before a PyPI release:
claude mcp add futu-opend-mcp -- uvx --from git+https://github.com/ER-EPR/futu-opend-mcp futu-opend-mcpOpen WebUI via mcpo (HTTP)
uvx mcpo --port 8000 -- futu-opend-mcp
# OpenAPI at http://localhost:8000, docs at /docsMCP JSON config
Add to ~/.claude/settings.json, .mcp.json, or Claude Desktop config:
Remote OpenD (with encryption):
{
"mcpServers": {
"futu-opend": {
"command": "uvx",
"args": ["futu-opend-mcp"],
"env": {
"FUTU_OPEND_HOST": "your-opend-host",
"FUTU_OPEND_PORT": "11111",
"FUTU_OPEND_ENCRYPT": "true",
"FUTU_OPEND_RSA_KEY": "-----BEGIN RSA PRIVATE KEY-----\\nMIIC...\\n-----END RSA PRIVATE KEY-----"
}
}
}
}Local OpenD (no encryption):
{
"mcpServers": {
"futu-opend": {
"command": "uvx",
"args": ["futu-opend-mcp"],
"env": {
"FUTU_OPEND_ENCRYPT": "false"
}
}
}
}Extract the RSA key for the env var:
docker exec futu-opend cat /rsa/rsa_private_pkcs1.pem | awk '{printf "%s\\n", $0}'Related MCP server: ibkr-mcp
Configuration (env vars)
Var | Default | Purpose |
|
| OpenD host |
|
| OpenD port |
| - | inline PEM of the shared RSA private key |
| - | path to the PEM file (alternative to above) |
|
| proto encryption; |
|
| logging level |
OpenD and the SDK share one RSA private key (PKCS#1 1024-bit). Get it from a dockerized
OpenD with: docker compose logs opend | grep -A20 'NEW RSA PRIVATE KEY'.
Tools
~50 read-only tools across: price/quote, search, screening, financials, research/valuation,
corporate actions, shareholders, profile, capital flow, short interest, options, option
underlying IV/HV, warrants/futures, plates, industrial chains, institutions, macro,
dividends, IPO, and diagnostics. See docs/superpowers/specs/2026-07-10-futu-opend-mcp-design.md.
Development
pip install -e ".[dev]"
pytest -q -m "not integration" # unit tests (no OpenD needed)
ruff check .Live-OpenD integration tests are marked integration and skip themselves when OpenD is
unreachable. Re-vendor the official skill pack with ./scripts/sync_skill.sh.
Attribution
Wraps the official Futu futuapi skill pack (vendored under
src/futu_opend_mcp/_skill/futuapi/, unmodified). Legal terms in that folder apply.
License
MIT.
Available Tools
53 toolsget_analyst_consensusC
Analyst consensus rating + target price - 分析师评级/一致预期/目标价/ consensus/analyst rating. Stocks + REITs.
Inputs: code (required).
get_capital_distributionC
Capital distribution (super/big/mid/small orders) - 资金分布/大单小单/主力资金.
Inputs: code (required).
get_capital_flowC
Capital flow time series (main-force in/out) - 资金流向/资金流入流出.
Inputs: code (required).
get_company_executivesC
Company executives & board - 公司高管/管理层/董事会/executives. Returns leader_name usable in get_executive_background.
Inputs: code (required).
get_company_profileD
Company profile - 公司概况/公司详情/公司简介/company profile/主营业务.
Inputs: code (required).
get_corporate_actionsA
Get corporate actions - 分红/派息/股息, 回购/buyback, or 拆股/合股/stock split. action_type selects which. Per-stock historical records; for a forward all-market dividend calendar use get_dividend_calendar instead.
Inputs: code (required), action_type (required).
get_dividend_calendarA
All-market forward dividend/ex-date calendar - 派息日历/除息日历. market: US/HK/...; date YYYY-MM-DD. Distinct from per-stock historical get_corporate_actions.
Inputs: date (required), market (required), count.
get_earnings_calendarC
Get earnings-release calendar for a market - 财报日历. market: US/HK/CN/SG/MY/JP.
Inputs: market (required), date, max_count.
get_earnings_price_historyC
Get per-earnings-day price detail + IV crush - 历史财报日数据明细/财报日股价历史/ IV Crush/财报预期波动率. HK/US stocks only.
Inputs: code (required).
get_economic_calendarC
Economic-event calendar - 经济事件日历. Optional market + date filter.
Inputs: date, market, max_count.
get_executive_backgroundA
Background/career history of a named executive - 高管背景/履历/CEO背景. Two-step: first get_company_executives to find leader_name, then call this.
Inputs: code (required), leader_name (required).
get_fed_watchC
CME FedWatch tool - FedWatch 目标利率概率 (target_rate) or 点阵图 (dot_plot).
Inputs: view.
get_financial_statementsB
Get financial statements - 财务报表/财报/利润表/资产负债表/现金流量表/ 关键指标. statement_type: 1=Income 2=BalanceSheet 3=CashFlow 4=MainIndex(关键指标). financial_type: 7=年报 10=单季报+年报(default) 9=单季组合. currency_code ISO 4217 (CNY/USD/HKD/...); omit for native currency.
Inputs: code (required), num, currency_code, financial_type, +1 more.
get_future_infoC
Get futures contract info (size, last trade day, sessions) - 期货合约信息. e.g. SG.CNmain.
Inputs: codes (required).
get_holder_detailC
Top-10 / detailed shareholders - 持股明细/十大股东/大股东名单. request_type 0=default 1000=all.
Inputs: code (required), num, request_type.
get_holding_changesC
Shareholder holding changes (increase/decrease/new/clear) - 持股变动/增持/减持/ 新进/清仓. filter_type: 0=all 1=increase 2=decrease 3=new 4=clear.
Inputs: code (required), num, filter_type.
get_industrial_chainsA
Browse industrial/supply chains - 产业链. view: list (chains in a market, optional keyword), detail (one chain's upstream/midstream/downstream - pass chain_id), by_plate (chains linked to a plate - pass plate_id). market needed for list.
Inputs: view, count, market, keyword, +2 more.
get_industrial_plateC
Industrial-plate info or constituents - 产业板块信息/成分股. view: info (plate detail) or stocks (constituents; optional markets filter like HK,US).
Inputs: plate_id (required), view, count, markets.
get_insider_dataB
US insider holdings/trades - 内部人持股/内部人交易/高管交易/Form 4. US stocks only. data_type: holders (insider holder list) or trades (insider trade list).
Inputs: code (required), data_type (required), num, holder_id.
get_institutional_holdingsA
By-stock institutional holdings history - 机构持股/机构持仓/13F (who holds THIS stock). For by-institution (which stocks an institution holds) use get_institution_holdings.
Inputs: code (required), num.
get_institution_distributionC
Institution holding industry distribution - 机构持仓行业分布.
Inputs: market (required), institution_id (required).
get_institution_holdingsA
By-institution holdings - 机构持股/持仓变动. view: list (an institution's holdings) or change (holding-change detail). change_type for change: NEW/INCREASE/DECREASE/CLEAR. This is the BY-INSTITUTION direction (which stocks an institution holds) - distinct from get_institutional_holdings (who holds a given stock).
Inputs: market (required), institution_id (required), num, view, +1 more.
get_institution_listA
List institutions in a market - 机构列表. Optional name fuzzy search (e.g. 桥水/Bridgewater). Returns institution_id usable in other institution tools.
Inputs: market (required), name, count.
get_institution_profileD
Institution profile - 机构概况/机构详情.
Inputs: market (required), institution_id (required).
get_ipo_listB
Get IPO list for a market - IPO/新股列表. market: HK/US/SH/SZ/SG/MY/JP.
Inputs: market (required).
get_klineA
Get K-line / candlestick / historical price (K线/蜡烛图/历史走势).
ktype: 1m,3m,5m,15m,30m,60m,1d,1w,1M,1Q,1Y. rehab: none/forward/backward
(forward=前复权 default). With start+end (YYYY-MM-DD) pulls historical K-line
across the range; otherwise the latest num bars. US intraday session not
exposed in v1.
Inputs: code (required), end, num, ktype, +2 more.
get_macro_indicatorB
Macro indicators - 宏观指标. view: list (available indicators, optional search) or history (time series for an indicator_id, optional begin/end).
Inputs: end, view, begin, search, +1 more.
get_market_stateC
Get market state (open/closed/lunch break) for codes - 市场状态/开盘了吗. Supports HK/US/SH/SZ/SG/MY/JP prefixes.
Inputs: codes (required).
get_morningstar_reportC
Morningstar research report - 晨星研报/fair value/护城河/moat/bull-bear. Stocks + REITs.
Inputs: code (required).
get_operational_efficiencyC
Operational efficiency - 经营效率/员工数/人均营收/人均利润/headcount per-employee metrics.
Inputs: code (required), num, currency_code.
get_option_chainA
Get option chain for an underlying - 期权链. HK/US stocks/ETF/index only. start/end YYYY-MM-DD filter by expiry.
Inputs: underlying (required), end, start.
get_option_expiration_dateB
List option expiration dates - 期权到期日. HK/US stocks/ETF/index only.
Inputs: underlying (required).
get_option_quoteA
Get option snapshot/Greeks for one or more legs - 期权快照/期权实时行情/多腿Greeks. legs: [{code, action: BUY|SELL, quantity}]. NOT for combo bid/ask - use get_option_strategy_analysis.
Inputs: legs (required).
get_option_strategy_analysisA
Combo option bid1/ask1 + P&L analysis - 组合摆盘价/损益分析/最大盈亏/盈亏平衡点. legs: [{code, action: BUY|SELL, quantity}]. PREFERRED source for combo bid/ask; do NOT sum single-leg snapshots.
Inputs: legs (required).
get_option_underlyingA
Option-underlying IV/HV data - 标的历史波动率/IV走势/P-C比率/批量标的快照. view: volatility (IV+HV time series, single code), statistic (volume/OI/PCR time series, single code), overview (latest snapshot, MULTIPLE codes). For overview pass a list; for volatility/statistic pass a single code + begin/end (≤364 days).
Inputs: code (required), view (required), end, begin.
get_option_volatilityA
Option volatility analysis (IV/HV) for a single option contract - 期权波动率/隐含波动率/ IV/HV. Input is an OPTION code (resolve via resolve_option_code first). query_time_period: 1=week 2=month 3=quarter 4=half 5=year.
Inputs: code (required), hv_time_period, query_time_period.
get_owner_plateC
Get plates a stock belongs to - 所属板块/属于哪些板块.
Inputs: codes (required).
get_plate_listB
List plates (concept/industry/region) - 板块列表/概念板块/行业板块. market: HK/US/SH/SZ/ SG/MY/JP. plate_type: ALL/INDUSTRY/REGION/CONCEPT.
Inputs: market (required), count, keyword, plate_type.
get_plate_stocksC
Get stocks in a plate or index - 板块成分股/指数成分股/恒指成分股. plate_code e.g. hsi (alias) or HK.BK1910.
Inputs: plate_code (required), limit.
get_quota_statusA
Self-diagnostics: aggregate user info, history-K-line quota, and global state - 用户行情权限/订阅配额/历史K线额度/市场开闭/登录状态. Call when a data tool returns a permission/quota error to diagnose the cause.
Inputs: no named parameters.
get_reference_securitiesB
Get securities related to a code (spot↔warrant/future/option) - 关联证券/正股关联涡轮期货. reference_type: WARRANT / FUTURE / OPTION (per SDK enum).
Inputs: code (required), reference_type.
get_revenue_breakdownB
Get revenue composition by product/industry/region/business - 主营构成/ 营收拆分/收入构成/revenue breakdown. financial_type: 7=年报 9=聚合季报.
Inputs: code (required), currency_code, financial_type.
get_short_dataB
Short-selling data - 每日卖空/卖空量/卖空比例 (volume) or 空头持仓/short interest/ days to cover (interest). HK/US.
Inputs: code (required), data_type (required), num.
get_snapshotA
Get market snapshot (latest price, OHLC, volume, bid/ask) for one or more stocks - no subscription needed. Use when the user asks for 报价/价格/ 行情/快照/quote/price/snapshot. Codes like US.AAPL, HK.00700, SH.600519. Up to 400 codes per call.
Inputs: codes (required).
get_stock_infoB
Get stock basic+snapshot info (name, lot size, market cap, PE) - 股票信息/ 基本信息. Underlying uses get_market_snapshot; up to 400 codes.
Inputs: codes (required).
get_top_brokersB
Top-10 buy/sell brokers (HK only) - 十大买卖经纪商/经纪队列排名. days_before: 0=realtime.
Inputs: code (required), days_before.
get_valuation_detailC
Valuation detail (PE/PB/PS trend, percentile, vs market) - 估值详情/ 市盈率/市净率/市销率/估值分位. valuation_type: 1=PE 2=PB 3=PS. interval_type: 1=3m 2=6m 3=1y 4=3y 5=since2019 6=5y 7=10y 8=2y 9=20y 10=30y.
Inputs: code (required), interval_type, valuation_type.
get_warrantC
Get warrants/cbbc list for an underlying - 窝轮/牛熊证/warrant. stock_owner e.g. HK.00700.
Inputs: stock_owner.
resolve_option_codeA
Resolve an option's Futu code from a description - 解析期权简写代码. underlying e.g. US.JPM; expiry YYYY-MM-DD; strike e.g. 267.50; option_type CALL/PUT. Returns a code like US.JPM260320C267500. Do NOT hand-build HK option codes (abbreviation differs) - use this.
Inputs: expiry (required), strike (required), underlying (required), option_type (required).
screen_stocksA
Screen stocks by multi-factor config (V2) - 条件选股/筛选/screen stocks. market: HK/US/SH/ SZ/SG/MY/JP. config_json: a JSON string with filters/retrieves/sort (see Futu V2 screen schema). Values are RAW (OpenD scales): PRICE 10.0, MARKET_CAP 1e10, change% 5.0 (not 0.05).
Inputs: market (required), config_json (required), page_count.
search_newsA
Search news/announcements/ratings by keyword - 搜索资讯/搜新闻/搜公告. news_sub_type: ALL/NEWS(notice=公告)/NOTICE/RATING. Returns title/source/ publish_time/related_securities/url. Rate-limited 10/30s.
Inputs: keyword (required), max_count, news_sub_type.
search_quoteA
Search securities/ETFs/plates by keyword - 搜索股票/搜代码/search quote. Returns market/code/name/sec_type. Rate-limited 10/30s. If unsure of a stock code, call this first.
Inputs: keyword (required), max_count.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 53 tools
Most tools have clearly distinct purposes, with detailed descriptions differentiating them. However, the pair get_institutional_holdings and get_institution_holdings are very similarly named and require careful reading to avoid confusion, slightly lowering the score.
All tool names follow a consistent verb_noun snake_case pattern (e.g., get_snapshot, search_quote, screen_stocks), making it predictable for agents.
With 53 tools, the server is extremely extensive. While the financial domain is broad, this number is excessive and may overwhelm agents, leading to difficulty in selecting the right tool.
The tool set covers a wide range of financial data needs including stocks, options, fundamentals, institutional holdings, and economic calendars. Minor gaps like lack of order book depth or tick data exist, but the core data surface is comprehensive.
Related MCP Connectors
Hosted MCP server for SEC, FRED, Polymarket, Deribit, OKX, and FMP.
MCP server for OpenMM — exposes market data, account, trading, and strategy tools to AI agents
Unofficial Market Data App MCP — wraps the Market Data App API (marketdata.app)
Trading MCP server for AI agents, with live market data, account reads and controlled execution.
Related MCP Servers
- AlicenseAqualityDmaintenanceRead-only MCP server for options research with server-side filtering to reduce token usage. Supports Tradier and Alpaca data providers.417 npm11MIT
- AlicenseAqualityDmaintenanceRead-only MCP server for Interactive Brokers that exposes market data, positions, and account info as MCP tools.8MIT
- AlicenseAqualityCmaintenanceA read-only MCP server exposing Toss Securities Open API tools for Korean and US stock quotes, symbol search, order books, candles, exchange rates, market calendars, rankings, and market indicators. It does not implement account access or order placement, ensuring no side effects.13MIT
- FlicenseAqualityDmaintenanceMCP server for read-only access to Charles Schwab market data and account information. It provides quotes, price history, technical indicators, fundamentals, option chains, market hours, movers, and account/transaction data via the official Schwab API.10-