Futu Stock MCP Server

What is Futu Stock MCP Server?

Futu Stock MCP Server is a Python server that wraps the Futu OpenAPI (for Futu securities) into the Model Context Protocol (MCP 2.0) standard. It allows AI models to subscribe to real-time market data and query stock information across Hong Kong, US, and A-share markets.

How to use Futu Stock MCP Server?

Install via pipx install futu-stock-mcp-server or run via Docker. Configure environment variables (FUTU_HOST, FUTU_PORT, FUTU_TRADE_ENV, etc.) in your MCP client’s env field. Start the server with futu-mcp-server. The server connects to the locally running Futu OpenD gateway and exposes MCP tools for data and trading operations.

Key features of Futu Stock MCP Server

• Fully compatible with MCP 2.0 protocol standard
• Real-time quotes for HK, US, and A-share markets
• Supports real-time data subscription and push
• Provides K-line, tick-by-tick, and order book data
• Secure API call and data access mechanism
• Includes trading tools and account query capabilities

Use cases of Futu Stock MCP Server

• Query live stock quotes from AI assistants or coding agents
• Retrieve historical K-line data for backtesting analysis
• Subscribe to real-time market data for automated monitoring
• Access account positions and funds via natural language prompts
• Execute trade orders (if trading is enabled) through MCP clients

FAQ from Futu Stock MCP Server

What are the prerequisites to use this server?

You need a Futu securities account with OpenAPI permissions, and the Futu OpenD gateway program must be installed and running. Python 3.10+ is required.

How do I configure the connection to OpenD?

Set the environment variables FUTU_HOST (default 127.0.0.1) and FUTU_PORT (default 11111) in your MCP client’s env field. No .env file is needed.

The futu-mcp-server command is not found. What should I do?

Ensure the package is correctly installed via pipx install futu-stock-mcp-server. Run which futu-mcp-server to check its path. If missing, verify that your .local/bin directory is in your PATH.

Can I run the server from source without installation?

Yes. Clone the repository, install dependencies with uv pip install -e ., then run python -m futu_stock_mcp_server.server. You can also use the python command in the MCP client configuration.

How do I enable trading features in the server?

Set FUTU_ENABLE_TRADING to 1 and FUTU_TRADE_ENV to SIMULATE or REAL in the client’s env configuration. Also set FUTU_SECURITY_FIRM and FUTU_TRD_MARKET appropriately.