Skip to main content
Glama
moomoo-market-data-mcp

moomoo-market-data-mcp

by amao69904

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 connection

  • moomoo_snapshot — market snapshots for one or more symbols

  • moomoo_quote — subscribed real-time quotes

  • moomoo_candles — current K-line/candlestick data

  • moomoo_order_book — real-time order book

  • moomoo_ticker — recent time-and-sales records

  • moomoo_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-mcp

Optional environment variables:

export FUTU_OPEND_HOST=127.0.0.1
export FUTU_OPEND_PORT=11111

Codex 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]"
pytest

License

MIT

Available Tools

7 tools
moomoo_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

    B3.2/5.0

    Scored across 7 tools

    Disambiguation4/5

    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.

    Naming Consistency4/5

    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.

    Tool Count5/5

    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.

    Completeness4/5

    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

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      C
      quality
      D
      maintenance
      Enables 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.
      71
      3
      MIT
    • A
      license
      Not graded
      quality
      B
      maintenance
      Unified 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.
      929
      MIT
    • A
      license
      C
      quality
      C
      maintenance
      Read-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.
      53
      9
      MIT