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.com/mcp(configuration link, cannot be openned directly).

Architecture Overview
Authorization Flow
Account & Capability Authorization
How To Connect Cloud MCP
How To Use 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 symbols to a watchlist
`create_watchlist`	Create a new watchlist
`delete_watchlist`	Delete a watchlist
`get_account_balance`	Get account balances and assets
`get_account_list`	Get all trading accounts
`get_account_positions`	Get account holdings and positions
`get_analyst_rating`	Get analyst ratings for a security
`get_analyst_target_price`	Get analyst target prices for a security
`get_company_profile`	Get company information and business details
`get_crypto_bars`	Get historical crypto price data
`get_crypto_instruments`	Get cryptocurrency information
`get_crypto_snapshot`	Get real-time crypto market data
`get_event_bars`	Get historical event contract data
`get_event_categories`	Get event market categories
`get_event_depth`	Get event contract order book data
`get_event_events`	Get events in an event series
`get_event_instruments`	Get event contract information
`get_event_series`	Get event market series
`get_event_snapshot`	Get real-time event market data
`get_event_tick`	Get event contract trade data
`get_futures_bars`	Get historical futures price data
`get_futures_depth`	Get futures order book data
`get_futures_footprint`	Get futures capital flow data
`get_futures_instruments`	Get futures contract information
`get_futures_product_class`	Get futures product categories
`get_futures_products`	Get futures product information
`get_futures_snapshot`	Get real-time futures market data
`get_futures_tick`	Get futures trade data
`get_gainers_losers`	Get top gainers and losers
`get_instruments`	Get stock and ETF information
`get_most_active`	Get the most actively traded stocks
`get_open_orders`	Get open and pending orders
`get_order_detail`	Get details of an order
`get_order_history`	Get historical orders
`get_stock_bars`	Get historical price data for multiple stocks
`get_stock_bars_single`	Get historical price data for a single stock
`get_stock_footprint`	Get stock capital flow data
`get_stock_quotes`	Get stock bid and ask quotes
`get_stock_snapshot`	Get real-time stock market data
`get_stock_tick`	Get stock trade data
`get_watchlist_instruments`	Get symbols in a watchlist
`get_watchlists`	Get all watchlists
`remove_watchlist_instruments`	Remove symbols from a watchlist
`update_watchlist`	Update a watchlist
`update_watchlist_instruments`	Update symbols in a watchlist

How To Connect Cloud MCP

Here are two demonstration videos to respectively introduce how to connect to the cloud-based MCP, including ChatPGT Apps and Claude Connectors.

ChatPGT 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.com/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.com/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.com/mcp"
    }
  }
}

Cherry Studio

Settings → MCP Servers → Add, then enter the URL above.

How To Use Cloud MCP

You can learn how to use it by watching the following video.

Quick Navigation​

Architecture Overview​

Authorization Flow​

Account & Capability Authorization​

Account Authorization​

Capability Authorization​

Available Endpoints​

How To Connect Cloud MCP​

ChatPGT Apps​

Claude Connectors​

Other AI Platform​

Codex​

Cursor​

Kiro​

Zed​

Cherry Studio​

How To Use Cloud MCP​

Quick Navigation