Webull Cloud MCP Server
Webull Cloud MCP is a fully managed MCP service hosted by Webull.
Unlike Local MCP, users do not need to install MCP Server, configure AI clients, manage API credentials, or perform local authentication.
Users simply connect their Webull account through OAuth authorization and immediately access Webull capabilities from supported AI platforms.
MCP Server URL Is:
https://api.webull.co.jp/mcp(configuration link, cannot be openned directly).
Quick Navigation
- Architecture Overview
- Authorization Flow
- Account & Capability Authorization
- How To Connect Cloud MCP
Architecture Overview
Authorization Flow
Webull Cloud MCP uses OAuth Authorization Code Flow.
Authentication supports:
- Mobile Number + Password + Trading Password
- Email + Password + Trading Password
Account & Capability Authorization
After successful login, users enter a unified authorization page.
Account Authorization
Users may authorize one or more accounts.
Example:
- Individual Cash
- Margin Account
- IRA Account
- Futures Account
Only selected accounts will be accessible through MCP.
Capability Authorization
Users may authorize capability groups independently.
Examples:
| Capability | Description |
|---|---|
| Account Infos | View account information, assets, and positions. Allows the AI assistant to access your authorized account details, including account profile, account balances, buying power, cash holdings, and current positions. |
| Order Query | View order history and trading activities. Allows the AI assistant to access your order records, execution history, and transaction status for authorized accounts. |
| Market Data | Access real-time and historical market data. Allows the AI assistant to retrieve market quotes, price movements, and related market information for supported securities. |
| Security Master | Access security reference and instrument information. Allows the AI assistant to retrieve basic information about supported financial instruments, including stocks, ETFs, options, futures, and other securities. |
This follows the Principle of Least Privilege.
Only explicitly authorized capabilities are available to AI platforms.
Available Endpoints
| Endpoint | Description |
|---|---|
| add_watchlist_instruments | Add instruments to a watchlist |
| create_watchlist | Create a new watchlist (max 20) |
| delete_watchlist | Delete a watchlist |
| get_52_week_high_low | Get 52-week high/low stocks ranking |
| get_account_balance | Get account balance and asset details |
| get_account_list | Get all trading accounts |
| get_account_position_details | Get position details (JP region) |
| get_account_positions | Get account positions |
| get_analyst_rating | Get analyst ratings for a security |
| get_analyst_target_price | Get analyst target price for a security |
| get_balance_sheet | Get balance sheet (US region only) |
| get_cash_flow | Get cash flow statement (US region only) |
| get_company_profile | Get company profile (industry, sector, CEO, etc.) |
| get_financial_alert | Get financial alert/risk indicators (US region) |
| get_financial_indicators | Get financial indicators (valuation ratios/metrics) |
| get_fund_allocation | Get fund/ETF asset allocation (US region) |
| get_fund_brief | Get fund/ETF brief profile (US region only) |
| get_fund_dividends | Get fund/ETF dividend history (US region) |
| get_fund_files | Get fund/ETF documents/files (US region only) |
| get_fund_holdings | Get fund/ETF holdings (US region only) |
| get_fund_net_value | Get fund/ETF net value history (US region) |
| get_fund_performance | Get fund/ETF performance (US region) |
| get_fund_rating | Get fund/ETF rating (US region only) |
| get_fund_splits | Get fund/ETF split history (US region only) |
| get_gainers_losers | Get top gainers and losers ranking |
| get_high_dividend | Get high dividend stocks ranking (US region) |
| get_income_statement | Get income statement (US region) |
| get_instruments | Get stock/ETF instrument information |
| get_market_sectors | Get market sectors overview (US region) |
| get_market_sectors_detail | Get market sector detail with stock list |
| get_most_active | Get most active stocks ranking |
| get_open_orders | Get current open/pending orders |
| get_order_detail | Get order details by client order ID |
| get_order_history | Get historical orders |
| get_stock_bars | Get OHLCV candlestick bars for multiple stocks |
| get_stock_bars_single | Get OHLCV candlestick bars for a single stock |
| get_stock_capital_flow | Get stock capital flow distribution (inflow/outflow) by date |
| get_stock_dividend_calendar | Get stock dividend calendar |
| get_stock_earnings_calendar | Get stock earnings calendar |
| get_stock_filings | Get stock SEC filings (US region only) |
| get_stock_footprint | Get stock large order footprint (order flow) |
| get_stock_forecast_eps | Get stock forecast EPS (analyst consensus estimate) |
| get_stock_industry_comparison | Get stock industry peer comparison and ranking |
| get_stock_noii_bars | Get NOII (Net Order Imbalance Indicator) K-line data |
| get_stock_noii_snapshot | Get the latest NOII (Net Order Imbalance Indicator) snapshot |
| get_stock_quotes | Get stock depth quotes (bid/ask) |
| get_stock_snapshot | Get real-time stock market snapshot |
| get_stock_tick | Get stock tick-by-tick trade data |
| get_watchlist_instruments | Get instruments in a watchlist |
| get_watchlists | Get all watchlists |
| remove_watchlist_instruments | Remove instruments from a watchlist |
| update_watchlist | Update watchlist name or sort order |
| update_watchlist_instruments | Update instrument sort order in a watchlist |
How To Use Cloud MCP
These two demonstration videos show how to connect and use to the Cloud MCP by ChatGPT Apps and Claude Connectors. For other AI platforms, we have provided some examples of connections.
ChatGPT Apps
You can log in to the ChatGPT platform to operate.
Claude Connectors
You can log in to the Claude platform to operate.
Other AI Platform
Codex
Run the following command in your terminal:
codex mcp add webull --url https://api.webull.co.jp/mcp
Then follow the OAuth authorization flow in Codex when prompted.
Cursor
Settings → MCP Servers → Add Remote MCP Server, then enter the URL above.
Kiro
Open the mcp.json by clicking on Cmd + Shift + P（Mac） or Ctrl + Shift + P（Windows）,Then make the following configurations:
{
"webull": {
"url": "https://api.webull.co.jp/mcp",
"disabled": false,
"autoApprove": []
}
}
Zed
Add the following to your settings.json under the context_servers key (key name is customizable):
{
"mcpServers": {
"webull": {
"url": "https://api.webull.co.jp/mcp"
}
}
}
Cherry Studio
Settings → MCP Servers → Add, then enter the URL above.