moomoo-market-data-mcp
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., "@moomoo-market-data-mcp Get the current snapshot for US.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.
moomoo Market Data MCP
A read-only Model Context Protocol server that exposes real-time market data from the official Futu OpenAPI (futu-api) to Codex and other MCP clients.
This project only provides market-data tools. It contains no order placement, account, position, or fund-transfer functions.
Tools
moomoo_connection_status— verify the Futu OpenD connectionmoomoo_snapshot— market snapshots for one or more symbolsmoomoo_quote— subscribed real-time quotesmoomoo_candles— current K-line/candlestick datamoomoo_order_book— real-time order bookmoomoo_ticker— recent time-and-sales recordsmoomoo_search_securities— search securities by code or name
Symbols use Futu's format, for example US.AAPL, HK.00700, and SH.600519.
Related MCP server: TickDB MCP
Requirements
Python 3.10+
Futu OpenD installed, logged in, and running
The required real-time quote entitlement in your moomoo/Futu account
The default OpenD endpoint is 127.0.0.1:11111. This server does not need your moomoo password.
Install and run
git clone https://github.com/amao69904/moomoo-market-data-mcp.git
cd moomoo-market-data-mcp
python -m venv .venv
source .venv/bin/activate
pip install -e .
moomoo-market-data-mcpOptional environment variables:
export FUTU_OPEND_HOST=127.0.0.1
export FUTU_OPEND_PORT=11111Codex MCP configuration
Add the server using the Python environment where it was installed:
[mcp_servers.moomoo-market-data]
command = "/absolute/path/to/moomoo-market-data-mcp/.venv/bin/moomoo-market-data-mcp"
[mcp_servers.moomoo-market-data.env]
FUTU_OPEND_HOST = "127.0.0.1"
FUTU_OPEND_PORT = "11111"Restart Codex after changing MCP configuration, then call moomoo_connection_status.
Data and safety notes
Availability, latency, depth, and coverage depend on OpenD, account region, exchange hours, and quote entitlements.
Subscription quotas are enforced by Futu.
Returned data is informational and is not investment advice.
Do not expose OpenD to the public internet. Keep it on localhost or a trusted private network.
Development
pip install -e ".[dev]"
pytestLicense
MIT
Available Tools
7 toolsmoomoo_candlesC
Return current candles. ktype examples: K_1M, K_5M, K_DAY.
Inputs: code (required), count, ktype, autype. Returns: result
moomoo_connection_statusA
Check whether the configured Futu OpenD endpoint is reachable.
Inputs: no named parameters. Returns: object
moomoo_order_bookB
Return the real-time bid/ask order book for one symbol.
Inputs: code (required), depth. Returns: object
moomoo_quoteC
Subscribe and return the latest real-time quote for each symbol.
Inputs: codes (required). Returns: result
moomoo_search_securitiesB
Search securities in a market such as US, HK, SH, or SZ.
Inputs: query (required), market (required), limit, security_type. Returns: result
moomoo_snapshotB
Get market snapshots. Symbols must look like US.AAPL or HK.00700.
Inputs: codes (required). Returns: result
moomoo_tickerC
Return recent real-time time-and-sales records for one symbol.
Inputs: code (required), count. Returns: result
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 7 tools
Most tools target clearly distinct market data products (candles, order book, ticker, search, connection status). Snapshot and quote could be somewhat confusable since both return current market state, but their descriptions generally clarify the difference.
All tools share a consistent moomoo_ prefix and snake_case convention. Most are noun-like resource names (snapshot, quote, candles, order_book, ticker), while search_securities is the only verb_noun form, which is a minor deviation.
Seven tools is well-scoped for a market data server. Each tool covers a major data type or operation without unnecessary bloat or noticeable redundancy.
The toolset covers the core market data surface: search, current snapshots, quotes, candles, order book, and time-and-sales. Historical candle retrieval and additional market-data products like options or index constituents are absent, but these are reasonable gaps.
Maintenance
Related MCP Connectors
Unofficial Market Data App MCP — wraps the Market Data App API (marketdata.app)
Public Gate market data MCP for spot, futures, margin, options, delivery, earn, and alpha.
Historical tick, order book and settlement data for Polymarket and Predict.fun crypto up/down markets, plus smart-money lists and backtest quotes, over a read-only MCP server.
Real-time crypto market data: candles, tickers, orderbooks across 13+ exchanges via MCP.
Related MCP Servers
- AlicenseCqualityDmaintenanceEnables querying real-time and historical financial market data for stocks, options, forex, and crypto, including quotes, trades, technical indicators, and reference data through a set of MCP tools.713MIT

TickDB MCPofficial
AlicenseNot gradedqualityBmaintenanceUnified real-time & historical market data API for Forex, stocks (US/HK/A-share), crypto, indices & precious metals. Tick, order book depth & K-line via REST + WebSocket. AI-native: MCP server, Skill & CLI.929MIT- AlicenseCqualityCmaintenanceRead-only MCP server that exposes Futu OpenD's investment-research quote APIs (stocks, options, futures, financials, news, etc.) as MCP tools, leveraging an already-running OpenD gateway with no separate authentication.539MIT
- FlicenseNot gradedqualityDmaintenanceProvides stock market data (search, quotes, real-time, charts) for A-share, Hong Kong, and US stocks via MCP tools.-