Webull OpenAPI — Claude Code MCP server: what it does, how to install
Connects Webull trading and market data to your coding assistant. Pulls real-time quotes, tracks fundamental indicators, and submits exchange orders.
claude mcp add webull-openapi-mcp -- uvx webull-openapi-mcpWhat Webull OpenAPI does
The MCP server hooks your assistant into Webull OpenAPI across multiple regions, including the US, Hong Kong, and Japan. It supplies real-time ticks, OHLCV bars, market depth, and auction NOII statistics for equities, options, futures, and crypto assets. You can screen stocks by volume or dividend yield, read balance sheets, and inspect analyst price targets.
Beyond data queries, the tool manages trading actions directly from the assistant. It handles order entry, cancellation, and position tracking. US accounts support multi-leg option strategies, conditional OCO orders, and algorithmic execution like TWAP or VWAP. Built-in symbol whitelisting and notional thresholds enforce risk boundaries before orders go out.
Running the server requires Python 3.10+, the uv tool, developer credentials (App Key and App Secret), and an active quote subscription. Without a paid market data package from Webull, endpoints returning book depth and snapshots fail to respond.
What it helps with
- fetch real-time order books, ticks, and OHLCV bars
- execute limit, market, and algorithmic orders like TWAP
- analyze quarterly balance sheets, cash flow, and dividend dates
- create watchlists and filter securities across market sectors
Example prompts for the agent
- Show daily bars and real-time bid-ask quotes for AAPL
- Preview a limit order to purchase 50 shares of TSLA at 200 dollars
- Display current account buying power and open portfolio positions
How to install Webull OpenAPI
Platform CLI
claude mcp add webull-openapi-mcp -- uvx webull-openapi-mcpuvx runs the command named after the package; if the README names another one, use uvx --from webull-openapi-mcp <command>
Platform CLI
codex mcp add webull-openapi -- uvx webull-openapi-mcpuvx runs the command named after the package; if the README names another one, use uvx --from webull-openapi-mcp <command>
Config file
{
"mcpServers": {
"webull-openapi": {
"command": "uvx",
"args": [
"webull-openapi-mcp"
]
}
}
}uvx runs the command named after the package; if the README names another one, use uvx --from webull-openapi-mcp <command>
Config file
{
"servers": {
"webull-openapi": {
"type": "stdio",
"command": "uvx",
"args": [
"webull-openapi-mcp"
]
}
}
}uvx runs the command named after the package; if the README names another one, use uvx --from webull-openapi-mcp <command>
Platform CLI
gemini mcp add webull-openapi uvx webull-openapi-mcpuvx runs the command named after the package; if the README names another one, use uvx --from webull-openapi-mcp <command>
Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about Webull OpenAPI
How do I install Webull OpenAPI in Claude Code?
Run claude mcp add webull-openapi-mcp -- uvx webull-openapi-mcp in your terminal. You must have Python 3.10 or newer available on your system.
What does Webull OpenAPI do?
It provides MCP tools to query Webull market quotes, review company financials, and submit trading orders through an AI assistant.
What accounts or keys are needed before using it?
You need a Webull developer profile to generate an App Key and App Secret. Accessing quotes also requires a market data subscription for your region.
