Webull Cloud MCP Server
Webull Cloud MCP 是由 Webull 託管的全託管 MCP 服務。
與本地 MCP 不同，使用者無需安裝 MCP Server、配置 AI 客戶端、管理 API 憑證或執行本地驗證。
使用者只需透過 OAuth 授權連接其 Webull 帳戶，即可從支援的 AI 平台立即存取 Webull 功能。
MCP Server URL 為：
https://api.webull.hk/mcp（配置連結，無法直接開啟）。
快速導航
架構概覽
授權流程
Webull Cloud MCP 使用 OAuth 授權碼流程。
驗證支援：
- 手機號碼 + 密碼 + 交易密碼
- 電子郵件 + 密碼 + 交易密碼
帳戶與功能授權
成功登入後，使用者將進入統一授權頁面。
帳戶授權
使用者可授權一個或多個帳戶。
範例：
- 個人現金帳戶
- 保證金帳戶
只有被選中的帳戶才能透過 MCP 存取。
功能授權
使用者可獨立授權各功能群組。
範例：
| 功能 | 描述 |
|---|---|
| 帳戶資訊 | 查看帳戶資訊、資產和持倉。允許 AI 助手存取您授權的帳戶詳情，包括帳戶概況、帳戶餘額、購買力、現金持有量和目前持倉。 |
| 訂單查詢 | 查看訂單歷史和交易活動。允許 AI 助手存取您授權帳戶的訂單記錄、執行歷史和交易狀態。 |
| 行情數據 | 存取即時和歷史行情數據。允許 AI 助手擷取支援證券的市場報價、價格走勢和相關市場資訊。 |
| 證券主檔 | 存取證券參考和工具資訊。允許 AI 助手擷取支援金融工具的基本資訊，包括股票、ETF、期權、期貨和其他證券。 |
這遵循最小權限原則。
只有明確授權的功能才可供 AI 平台使用。
可用端點
| 端點 | 描述 |
|---|---|
add_watchlist_instruments | 新增標的至自選列表 |
create_watchlist | 建立新自選列表 |
delete_watchlist | 刪除自選列表 |
get_52_week_high_low | 取得 52 週新高/新低股票排行 |
get_account_balance | 取得帳戶餘額資訊 |
get_account_list | 取得所有已連結帳戶 |
get_account_positions | 取得帳戶持倉 |
get_analyst_rating | 取得股票分析師評級 |
get_analyst_target_price | 取得股票分析師目標價 |
get_balance_sheet | 取得股票資產負債表 |
get_cash_flow | 取得股票現金流量表 |
get_company_profile | 取得公司概況資訊 |
get_financial_alert | 取得股票財務警報 |
get_financial_indicators | 取得股票財務指標 |
get_fund_allocation | 取得基金資產配置 |
get_fund_brief | 取得基金簡介資訊 |
get_fund_dividends | 取得基金股息歷史 |
get_fund_files | 取得基金文件/文檔 |
get_fund_holdings | 取得基金前十大持倉 |
get_fund_net_value | 取得基金淨值（NAV）歷史 |
get_fund_performance | 取得基金績效回報 |
get_fund_rating | 取得基金評級歷史 |
get_fund_splits | 取得基金拆分歷史 |
get_futures_bars | 取得期貨 OHLCV K 線數據 |
get_futures_depth | 取得期貨訂單簿深度 |
get_futures_footprint | 取得期貨大單足跡 |
get_futures_instruments | 取得期貨工具資訊 |
get_futures_product_class | 取得期貨產品分類群組 |
get_futures_products | 取得期貨產品及產品代碼 |
get_futures_snapshot | 取得期貨即時快照 |
get_futures_tick | 取得期貨逐筆交易數據 |
get_gainers_losers | 取得漲跌幅排行榜 |
get_high_dividend | 取得高股息股票排行 |
get_income_statement | 取得股票損益表 |
get_instruments | 按代碼或類別取得工具資訊 |
get_market_sectors | 取得市場板塊概覽排行 |
get_market_sectors_detail | 取得特定市場板塊的股票列表 |
get_most_active | 取得最活躍交易股票排行 |
get_open_orders | 取得所有目前掛單 |
get_option_bars | 取得期權 OHLCV K 線數據 |
get_option_snapshot | 取得期權即時快照 |
get_option_tick | 取得期權逐筆交易數據 |
get_order_detail | 取得單筆訂單詳情 |
get_order_history | 取得歷史訂單 |
get_stock_bars | 取得多檔股票 K 線數據 |
get_stock_bars_single | 取得單檔股票 K 線數據 |
get_stock_capital_flow | 取得股票資金流向分佈 |
get_stock_dividend_calendar | 取得股票股息日曆 |
get_stock_earnings_calendar | 取得股票財報日曆 |
get_stock_filings | 取得股票 SEC 申報文件 |
get_stock_footprint | 取得股票大單足跡 |
get_stock_forecast_eps | 取得股票預測每股盈餘 |
get_stock_industry_comparison | 取得股票行業比較 |
get_stock_noii_bars | 取得股票 NOII K 線數據 |
get_stock_noii_snapshot | 取得股票最新 NOII 快照 |
get_stock_quotes | 取得股票買賣報價 |
get_stock_snapshot | 取得股票即時快照 |
get_stock_tick | 取得股票逐筆交易數據 |
get_watchlist_instruments | 取得自選列表中所有標的 |
get_watchlists | 取得使用者所有自選列表 |
remove_watchlist_instruments | 從自選列表中移除標的 |
update_watchlist | 更新自選列表名稱或排序 |
update_watchlist_instruments | 更新自選列表中標的的排序 |
如何使用 Cloud MCP
以下兩個示範影片展示如何透過 ChatGPT Apps 和 Claude Connectors 連接和使用 Cloud MCP。對於其他 AI 平台，我們提供了一些連接範例。
ChatGPT Apps
您可以登入 ChatGPT 平台進行操作。
Claude Connectors
您可以登入 Claude 平台進行操作。
其他 AI 平台
Codex
在終端機中執行以下命令：
codex mcp add webull --url https://api.webull.hk/mcp
然後在 Codex 提示時按照 OAuth 授權流程操作。
Cursor
設定 → MCP Servers → Add Remote MCP Server，然後輸入上述 URL。
Kiro
透過點擊 Cmd + Shift + P（Mac） 或 Ctrl + Shift + P（Windows） 開啟 mcp.json，然後進行以下配置：
{
"webull": {
"url": "https://api.webull.hk/mcp",
"disabled": false,
"autoApprove": []
}
}
Zed
在 settings.json 的 context_servers 鍵下新增以下內容（鍵名可自訂）：
{
"mcpServers": {
"webull": {
"url": "https://api.webull.hk/mcp"
}
}
}
Cherry Studio
設定 → MCP Servers → Add，然後輸入上述 URL。