/api

Webull MCP: connect your AI agent to Webull

Webull's MCP lets ChatGPT, Claude, Cursor and other AI agents read your account and draft trades on Webull. Here is how to set it up, what it can't do, and how to add research with sources.

Finks is not affiliated with or endorsed by Webull.

Try Finks for free

Get set up in minutes. Free tier, no card required.

Webull Cloud MCP (server URL)

https://api.webull.com/mcp

Finks MCP (research)

// Copy your MCP URL from the Finks API console
// Cursor: ~/.cursor/mcp.json
{
  "mcpServers": {
    "finks-api": {
      "url": "<your MCP URL from the console>",
      "headers": { "Authorization": "Bearer fk_test_..." }
    }
  }
}

// Claude Code
claude mcp add --transport http finks-api "<your MCP URL from the console>" \
  --header "Authorization: Bearer $FINKS_API_KEY"

What is the Webull MCP?

The Webull MCP connects ChatGPT, Claude, Cursor and other AI agents to your Webull account. There are two ways in: a Webull-hosted Cloud MCP and a local server you run yourself.

Cloud MCP
A Webull-hosted server. Find Webull in Claude's connector directory or ChatGPT Plugins, or paste https://api.webull.com/mcp into your agent. Sign in with Webull OAuth (password plus trading password), then choose which accounts and permissions to share. No software to install and no API keys.
Local MCP
Runs on your machine via uvx webull-openapi-mcp serve, with your OpenAPI App Key and App Secret. The older webull-mcp-server repository is deprecated.
Listed since
Claude's directory listing says "Added July 2026". Webull's page gives no date.
ChatGPT listing
ChatGPT's listing describes the plugin as read-only, while Webull's page says agents can place trades.

Connect ChatGPT, Claude or Cursor to the Webull MCP

Webull's local MCP server supports the US, HK, JP, SG, MY, UK, MX, BR and ZA regions, set with WEBULL_REGION_ID. The Cloud MCP is available to eligible Webull users in the US. Webull's local server needs a market data subscription; its Cloud MCP pages don't state plan requirements.

  1. 1.Open ChatGPT Plugins and search for Webull
  2. 2.Install the plugin
  3. 3.Sign in with Webull OAuth

Webull MCP limits

Webull's own rules for AI agents.

Order confirmation
Each trade needs separate confirmation before it goes to market.
Safety controls
Preview every order, use the optional read-only mode, and set hard limits on order size and value or a list of symbols.
Local server needs
A Webull developer account, API credentials and a market data subscription.
Sandbox
The local server starts in the UAT sandbox until you set WEBULL_ENVIRONMENT=prod.
Read-only locally
Set WEBULL_TOOLSETS=account,market-data to turn off trading tools.

Add research with sources to Webull's MCP

Webull's MCP gives your agent company profiles, analyst ratings and price targets, and research on fundamentals and filings.

Add the Finks MCP server beside it, and your agent can search in plain English and get back the passages that answer it, each with its source (news, SEC filings and earnings call transcripts).

mcp.json

// Copy your MCP URL from the Finks API console
// Cursor: ~/.cursor/mcp.json
{
  "mcpServers": {
    "finks-api": {
      "url": "<your MCP URL from the console>",
      "headers": { "Authorization": "Bearer fk_test_..." }
    }
  }
}

// Claude Code
claude mcp add --transport http finks-api "<your MCP URL from the console>" \
  --header "Authorization: Bearer $FINKS_API_KEY"
  1. 01

    "What did Nvidia say about export restrictions in its 10-Q?"

    finks_search

    {
  "type": "filing",
  "title": "NVIDIA CORP — 10-Q",
  "published_at": "2025-11-19T21:36:17Z",
  "url": "https://www.sec.gov/Archives/edgar/data/1045810/000104581025000230/nvda-20251026.htm",
  "passage": {
    "section_id": "10-q/part-1-item-2",
    "text": "…The replacement rule may impose new restrictions on our products or operations and/or add license requirements that could have a material impact on our business, operating results, and financial condition…"
  }
}
  2. 02

    "Which chipmakers mentioned supply constraints in recent news? Cite each source."

    finks_search

    {
  "type": "brief",
  "title": "Arm ($ARM) CEO: Chip Shortages Hinder AI Cancer Research and Robotics",
  "published_at": "2026-09-11T08:35:31Z",
  "publishers": ["myjoyonline.com", "bmmagazine.co.uk", "thesun.co.uk"],
  "url": "https://finks.ai/briefs/672Tyhi5hla9"
}
  3. 03

    "Why did AMD shares move today? Give me the sources."

    finks_search

    {
  "type": "brief",
  "title": "Semiconductor Stocks Fall as Advanced Micro Devices ($AMD) Drops $33.72 on Profit-Taking",
  "published_at": "2026-10-14T21:03:30Z",
  "publishers": ["marketbeat.com", "themarketsdaily.com", "dailypolitical.com"],
  "url": "https://finks.ai/briefs/i6SzWYY7ceVH"
}

Real responses, test key, 20 and 26 Oct 2026. Trimmed.

Finks returns information with its source. It does not give investment advice or tell your agent what to trade.

Related pages

Questions about the Webull MCP

What is the Webull MCP?

It connects ChatGPT, Claude, Cursor and other MCP-compatible agents to your Webull account, through a Webull-hosted Cloud MCP or a local server.

Does Webull have an MCP server?

Yes. Webull offers a hosted Cloud MCP and a local server you run with uvx.

Do I need API keys?

Not for the Cloud MCP. It uses Webull OAuth sign-in. The local server needs an App Key and App Secret.

Can I use ChatGPT with Webull?

Yes. Webull lists ChatGPT, and you can install the Webull plugin from ChatGPT Plugins.

Can I test without real money?

The local server starts in Webull's UAT sandbox until you switch it to production.

Is it free?

Webull's OpenAPI page lists "Free Level 1 Streaming Quotes for U.S. Market". Regulatory and exchange fees apply to trades, and Webull's pages don't list a price for deeper market data (webull.com/open-api, checked 21 Oct 2026).

How do I get a Finks API key?

Sign up for the Finks API console with your email and create a test key; no card needed. For production access, join the waitlist from the console.

Sources

Finks is not affiliated with or endorsed by Webull.

Research before your agent trades on Webull

Add the Finks MCP for news, filings and earnings calls with sources.

Try Finks for free