系统 / 状态

MCP 工具总览

futu_get_global_state

• Scope: qot:read
• Python SDK 等价: OpenQuoteContext.get_global_state
• 路由: MCP JSON-RPC tools/call name = "futu_get_global_state"

说明:

Get gateway global state: per-market trading status, server version / time, quote & trade login status. Python SDK: OpenContext.get_global_state.

JSON-RPC 调用示例:

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "futu_get_global_state",
    "arguments": {}
  }
}

返回结构: 与对应 REST endpoint / Python SDK 返回结构一致的 JSON 文本。失败时 MCP CallToolResult.is_error=true + 内容带 {"error": "...", "status": "error"}。

futu_get_user_info

• Scope: qot:read
• Python SDK 等价: OpenQuoteContext.get_user_info
• 路由: MCP JSON-RPC tools/call name = "futu_get_user_info"

说明:

Get user info: nickname, per-market quote permissions, subscribe quota, history-K quota. Python SDK: OpenContext.get_user_info.

JSON-RPC 调用示例:

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "futu_get_user_info",
    "arguments": {}
  }
}

返回结构: 与对应 REST endpoint / Python SDK 返回结构一致的 JSON 文本。失败时 MCP CallToolResult.is_error=true + 内容带 {"error": "...", "status": "error"}。

futu_get_quote_rights

• Scope: qot:read
• Python SDK 等价: — (gateway user profile / quote-right display surface)
• 路由: MCP JSON-RPC tools/call name = "futu_get_quote_rights"

说明:

Get quote-rights profile grouped like Futu OpenD GUI: HK/US/CN/SG/JP/crypto permissions, raw values, labels and quota. Set refresh=true to trigger request_highest_quote_right first.

请求参数:

字段	类型	必填	Alias	说明
refresh	boolean?	—	—	If true, trigger request_highest_quote_right before querying

⚠️ 未知字段: 启用 deny_unknown_fields — 任何未在表里的字段会返 unknown field error（之前静默 drop）。

JSON-RPC 调用示例:

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "futu_get_quote_rights",
    "arguments": {}
  }
}

返回结构: 与对应 REST endpoint / Python SDK 返回结构一致的 JSON 文本。失败时 MCP CallToolResult.is_error=true + 内容带 {"error": "...", "status": "error"}。

futu_get_delay_statistics

• Scope: qot:read
• Python SDK 等价: OpenQuoteContext.get_delay_statistics
• 路由: MCP JSON-RPC tools/call name = "futu_get_delay_statistics"

说明:

Get delay-statistics summary: counts of quote-push / request-reply / place-order samples. Python SDK: OpenContext.get_delay_statistics. For raw per-segment buckets use REST /api/delay-statistics.

JSON-RPC 调用示例:

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "futu_get_delay_statistics",
    "arguments": {}
  }
}

返回结构: 与对应 REST endpoint / Python SDK 返回结构一致的 JSON 文本。失败时 MCP CallToolResult.is_error=true + 内容带 {"error": "...", "status": "error"}。

futu_verification

• Scope: auth:setup
• Python SDK 等价: —
• 路由: MCP JSON-RPC tools/call name = "futu_verification"

说明:

Request or submit the current pre-login verification challenge. c2s_json uses Verification.C2S JSON.

请求参数:

字段	类型	必填	Alias	说明
c2s_json	string	✅	—	Official generated C2S JSON. Field names use generated proto serde snake_case, e.g. multi_legs / combo_legs / order_type.
api_key	string?	—	—	Optional per-call API key plaintext. HTTP scope mode still requires a valid Bearer on every /mcp request; this field overrides that identity for the tool handler. In stdio mode: tool argument > startup key.

⚠️ 未知字段: 启用 deny_unknown_fields — 任何未在表里的字段会返 unknown field error（之前静默 drop）。

JSON-RPC 调用示例:

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "futu_verification",
    "arguments": {
      "c2s_json": "…",
      "api_key": "optional-per-call-api-key"
    }
  }
}

返回结构: 与对应 REST endpoint / Python SDK 返回结构一致的 JSON 文本。失败时 MCP CallToolResult.is_error=true + 内容带 {"error": "...", "status": "error"}。

futu_ping

• Scope: qot:read
• Python SDK 等价: — (gateway-local, no SDK equivalent)
• 路由: MCP JSON-RPC tools/call name = "futu_ping"

说明:

Ping the Futu gateway. Returns RTT and connection status.

JSON-RPC 调用示例:

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "futu_ping",
    "arguments": {}
  }
}

返回结构: 与对应 REST endpoint / Python SDK 返回结构一致的 JSON 文本。失败时 MCP CallToolResult.is_error=true + 内容带 {"error": "...", "status": "error"}。

futu_push_subscriber_info

• Scope: acc:read
• Python SDK 等价: — (daemon-only diagnostics)
• 路由: MCP JSON-RPC tools/call name = "futu_push_subscriber_info"

说明:

Diagnostic — list active push subscriptions on this MCP server. Returns {total_count, subscriptions: [{session_id, acc_ids, age_secs}]}. Useful to verify whether futu_sub_acc_push registered, check auto-purge timing, or debug missing pushes.

JSON-RPC 调用示例:

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "futu_push_subscriber_info",
    "arguments": {}
  }
}

返回结构: 与对应 REST endpoint / Python SDK 返回结构一致的 JSON 文本。失败时 MCP CallToolResult.is_error=true + 内容带 {"error": "...", "status": "error"}。