Moomoo

CI Release

A Model Context Protocol (MCP) server for the Moomoo/Futu trading platform, written in Go.

Provides read-only trading tools (system health, market data, account info) via MCP stdio transport, suitable for use with Claude Desktop or any MCP client.

Responses are kept token-efficient by design — columnar output, number rounding, and opt-in column selection all reduce what gets sent into the LLM's context window (see Token-efficient output).

Available tools

Done	Domain	Tool	Description
✅	System	check_health	Check connectivity to the OpenD gateway.
✅	Market data	get_stock_quote	Real-time basic quote for one or more securities.
✅	Market data	get_market_snapshot	Current price snapshot for one or more securities.
✅	Market data	get_historical_klines	Historical K-line (candlestick) data.
✅	Market data	get_order_book	Current bid/ask order book for a security.
✅	Account	get_accounts	List trading accounts visible to this OpenD session.
✅	Account	get_assets	Funds/asset info (cash, buying power, market value) for an account.
✅	Account	get_positions	Open positions for an account.
✅	Account	get_account_summary	Combined assets + positions summary for an account.
✅	Account	get_max_tradable	Maximum tradable quantities for a security under an account.
✅	Account	get_margin_ratio	Margin ratio info for one or more securities under an account.
✅	Account	get_cash_flow	Trading cash flow summary for an account on a given date.
✅	Watchlist	get_user_security_group	List the user's watchlist groups.
✅	Watchlist	get_user_security	List securities within a watchlist group.
✅	Order history	get_orders	Today's orders for an account.
✅	Order history	get_deals	Today's filled deals for an account.
✅	Order history	get_history_orders	Historical orders for an account.
✅	Order history	get_history_deals	Historical filled deals for an account.
⬜	Trading	unlock_trade	Unlock a REAL account for trading (uses MOOMOO_TRADE_PASSWORD/_MD5 and MOOMOO_SECURITY_FIRM).
⬜	Trading	place_order / modify_order / cancel_order	Submit, change, or cancel an order.

This server is read-only today — no order can be placed. Trading tools are planned for a later phase.

Token-efficient output

Since responses go straight into an LLM's context window, this server trims output to reduce token usage:

• Columnar format for multi-row tools. get_historical_klines, get_history_orders, and get_history_deals can return many rows. Instead of an array of objects (which repeats every field name on every row), these tools return a single {"columns": [...], "rows": [[...], ...]} object — field names are sent once instead of once per row.

  {
    "columns": ["time", "open", "high", "low", "close", "volume", "turnover", "change_rate"],
    "rows": [
      ["2024-01-01", 123.45, 124.0, 122.5, 123.8, 1000000, 123456789, 0.023]
    ]
  }
  

• Field selection (fields). The same three tools accept an optional fields argument to control which columns are returned, in the order given. Omitting it returns a lean default set rather than every column:

  Tool	Default columns	All columns
  get_historical_klines	time, open, high, low, close, volume	adds turnover, change_rate
  get_history_orders	order_id, code, name, trd_side, order_type, order_status, qty, price, fill_qty, fill_avg_price, create_time, update_time	adds order_id_ex, remark, last_err_msg
  get_history_deals	fill_id, order_id, code, name, trd_side, qty, price, create_time, status	adds fill_id_ex, order_id_ex, counter_broker_name

  Requesting an unknown column name returns a tool error listing the valid columns.

• Number rounding. Prices, change rates, and turnover figures across snapshots, quotes, klines, and the order book are rounded to a sensible precision (prices to 3 decimals, rates to 4 decimals, turnover to a whole number) — dropping digits no caller acts on.

  Exception: US, HK, and SG allow sub-penny tick sizes below $1 (e.g. the US SEC's $0.0001 tick for stocks under $1), so prices below 1 in those markets are left unrounded to avoid losing real precision. JP and CN (SH/SZ) don't need this — JPY has no sub-unit and CNY uses a flat 0.01 tick, so prices in those markets are always safely covered by the 3-decimal rounding.

  Set MOOMOO_DISABLE_ROUNDING=true to turn off all rounding and get raw SDK values instead.

Prerequisites

1. Download and run OpenD from https://www.moomoo.com/download/OpenAPI
2. Log in to OpenD with your Moomoo/Futu account.
3. OpenD listens on 127.0.0.1:11111 by default.

Connection handling

The server does not require OpenD to be running when it starts. It connects to OpenD lazily on the first tool call and reconnects automatically after a drop (e.g. OpenD restart), so you never have to restart the MCP server or run /mcp reconnect because of an OpenD blip. When OpenD is unreachable, tools return a connection error and check_health reports connected: false instead of the server exiting.

Configuration

Environment Variable	Default	Description
MOOMOO_OPEND_HOST	127.0.0.1	OpenD host
MOOMOO_OPEND_PORT	11111	OpenD port
MOOMOO_TRADE_PASSWORD	–	Safety gate for REAL-account access (see below). Its value is not sent to OpenD yet — trading is not implemented.
MOOMOO_TRADE_PASSWORD_MD5	–	MD5 form of MOOMOO_TRADE_PASSWORD; same effect.
MOOMOO_SECURITY_FIRM	–	Not used yet; reserved for the future unlock_trade tool.
MOOMOO_DISABLE_ROUNDING	false	Set to true to disable number rounding (see Token-efficient output) and return raw SDK values.

By default (no trade password set) the server is SIMULATE-only: account tools (get_assets, get_positions, etc.) can only query SIMULATE accounts, and requests with trd_env=REAL are rejected. Setting MOOMOO_TRADE_PASSWORD (or _MD5) lifts this gate so the read-only account tools can also query REAL accounts — it does not unlock trading itself. Once trading tools are implemented, MOOMOO_TRADE_PASSWORD/_MD5 and MOOMOO_SECURITY_FIRM will also be used to authorize unlock_trade on a REAL account.

Installation

Download a release binary

Prebuilt binaries for macOS, Linux, and Windows (amd64/arm64) are published on the releases page. Download the archive for your platform, extract it, and place moomoo-mcp (or moomoo-mcp.exe) somewhere on your PATH.

Build from source

go build -o moomoo-mcp ./cmd/moomoo-mcp

Usage

# Run (SIMULATE-only, no trade password set)
./moomoo-mcp

# Run (allow REAL-account queries)
export MOOMOO_TRADE_PASSWORD="your-password"
export MOOMOO_SECURITY_FIRM="FUTUSG"
./moomoo-mcp

Claude Desktop

Claude Desktop is officially available on macOS and Windows. Config file location:

OS	Path
macOS	~/Library/Application Support/Claude/claude_desktop_config.json
Windows	%APPDATA%\Claude\claude_desktop_config.json

Add the moomoo entry under mcpServers:

{
  "mcpServers": {
    "moomoo": {
      "command": "/path/to/moomoo-mcp",
      "env": {
        "MOOMOO_OPEND_HOST": "127.0.0.1",
        "MOOMOO_OPEND_PORT": "11111"
      }
    }
  }
}

Restart Claude Desktop after saving.

Claude Code CLI

Use claude mcp add to register the server. The -s flag controls where the config is stored:

# User-level (available in all projects, stored in ~/.claude.json)
claude mcp add -s user moomoo /path/to/moomoo-mcp

# Project-level (stored in .mcp.json in the project directory, can be shared via git)
claude mcp add -s project moomoo /path/to/moomoo-mcp

With environment variables (e.g. to allow REAL-account queries):

claude mcp add -s user moomoo \
  -e MOOMOO_TRADE_PASSWORD=your-password \
  -e MOOMOO_SECURITY_FIRM=FUTUSG \
  -- /path/to/moomoo-mcp

Verify the server is registered and healthy:

claude mcp list
claude mcp get moomoo

License

Apache-2.0 — see LICENSE.