diff --git a/.cursor-plugin/marketplace.json b/.cursor-plugin/marketplace.json index 9ce7dd99b..01be4f893 100644 --- a/.cursor-plugin/marketplace.json +++ b/.cursor-plugin/marketplace.json @@ -367,6 +367,11 @@ "name": "gamma", "source": "third_party/gamma", "description": "Generate presentations, documents, and webpages." + }, + { + "name": "webull", + "source": "third_party/webull", + "description": "View accounts, positions, orders, watchlists, and market data." } ] } diff --git a/README.md b/README.md index 1e3394220..4bde54600 100644 --- a/README.md +++ b/README.md @@ -74,6 +74,7 @@ Official Cursor plugins for popular developer tools, frameworks, and SaaS produc | `gamma` | [Gamma](third_party/gamma/) | Cursor | Integrations | Generate presentations, documents, and webpages. | | `teams` | [Teams](third_party/teams/) | Cursor | Productivity | Search, read, and send Microsoft Teams chats and channel messages. | | `finance` | [Finance](third_party/finance/) | Cursor | Integrations | Securely connect your accounts so Grok can help with questions about your spending, subscriptions, balances, and investments. | +| `webull` | [Webull](third_party/webull/) | Cursor | Integrations | View accounts, positions, orders, watchlists, and market data. | Author values match each plugin’s `plugin.json` `author.name` (Cursor lists `plugins@cursor.com` in the manifest). ## Repository structure diff --git a/third_party/webull/.cursor-plugin/plugin.json b/third_party/webull/.cursor-plugin/plugin.json new file mode 100644 index 000000000..59fa82fa4 --- /dev/null +++ b/third_party/webull/.cursor-plugin/plugin.json @@ -0,0 +1,35 @@ +{ + "name": "webull", + "displayName": "Webull", + "version": "1.0.0", + "minClientVersions": { + "cursor": "3.13.0" + }, + "description": "View accounts, positions, orders, watchlists, and market data.", + "author": { + "name": "Cursor", + "email": "plugins@cursor.com" + }, + "homepage": "https://developer.webull.com/apis/docs/AI-friendly-Resources/mcp/", + "repository": "https://github.com/cursor/plugins", + "license": "MIT", + "logo": "assets/logo.png", + "keywords": [ + "webull", + "brokerage", + "trading", + "portfolio", + "quotes", + "watchlists", + "market data", + "mcp" + ], + "category": "integrations", + "tags": [ + "webull", + "finance", + "trading", + "mcp" + ], + "mcpServers": "./mcp.json" +} diff --git a/third_party/webull/CHANGELOG.md b/third_party/webull/CHANGELOG.md new file mode 100644 index 000000000..9997049a3 --- /dev/null +++ b/third_party/webull/CHANGELOG.md @@ -0,0 +1,9 @@ +# Changelog + +All notable changes to this plugin will be documented here. + +## 1.0.0 — initial release + +- Added the `webull` MCP server pointing at Webull's hosted Streamable HTTP endpoint (`https://api.webull.com/mcp`). +- Auth uses OAuth with Webull user login — no API key or client ID to configure. +- Logo: Webull's official mark, from the icon Webull publishes for its connector, on a 192×192 tile. diff --git a/third_party/webull/LICENSE b/third_party/webull/LICENSE new file mode 100644 index 000000000..ca2bba771 --- /dev/null +++ b/third_party/webull/LICENSE @@ -0,0 +1,21 @@ +MIT License + +Copyright (c) 2026 Cursor + +Permission is hereby granted, free of charge, to any person obtaining a copy +of this software and associated documentation files (the "Software"), to deal +in the Software without restriction, including without limitation the rights +to use, copy, modify, merge, publish, distribute, sublicense, and/or sell +copies of the Software, and to permit persons to whom the Software is +furnished to do so, subject to the following conditions: + +The above copyright notice and this permission notice shall be included in all +copies or substantial portions of the Software. + +THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR +IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, +FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE +AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER +LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, +OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE +SOFTWARE. diff --git a/third_party/webull/README.md b/third_party/webull/README.md new file mode 100644 index 000000000..f63f4e144 --- /dev/null +++ b/third_party/webull/README.md @@ -0,0 +1,60 @@ +# Webull + +Cursor plugin that connects agents to [Webull](https://developer.webull.com/apis/docs/AI-friendly-Resources/mcp/) through Webull's official remote [Model Context Protocol](https://modelcontextprotocol.io/) server. + +View accounts, positions, orders, watchlists, and market data. + +## Install + +1. Open **Cursor Settings → Plugins**. +2. Search for **Webull**. +3. Click **Install**, then complete the Webull sign-in prompt. + +Or run `/add-plugin webull` in chat. + +## MCP + +```json +{ + "mcpServers": { + "webull": { + "type": "http", + "url": "https://api.webull.com/mcp" + } + } +} +``` + +Auth is OAuth. Cursor prompts for Webull sign-in when the plugin connects — there is no client ID or personal access token to configure. + +## Before you connect + +You need a Webull account. During sign-in you choose which accounts and capability groups (account info, order query, market data, security master) to expose. + +## What agents can do + +| Category | Capabilities | +| --- | --- | +| Accounts | Balances, account list, and positions | +| Orders | Open orders, order history, and order detail | +| Market data | Stocks, crypto, futures, and event contracts: quotes, bars, ticks, rankings | +| Research | Company profiles, analyst ratings, filings, financial statements, and fund data | +| Watchlists | Create and manage watchlists | + +The hosted runtime is the source of truth for tool names and schemas. + +## Notes + +- The hosted server is read-only for trading: order placement, modification, and cancellation are only in Webull's local MCP server. +- Hong Kong accounts use a separate regional endpoint that this plugin does not configure. + +## Docs + +- Webull Cloud MCP: https://developer.webull.com/apis/docs/AI-friendly-Resources/mcp/ +- Server URL: https://api.webull.com/mcp + +Logo is Webull's official mark. + +## License + +MIT diff --git a/third_party/webull/assets/logo.png b/third_party/webull/assets/logo.png new file mode 100644 index 000000000..2d28680c6 Binary files /dev/null and b/third_party/webull/assets/logo.png differ diff --git a/third_party/webull/mcp.json b/third_party/webull/mcp.json new file mode 100644 index 000000000..9c8d94418 --- /dev/null +++ b/third_party/webull/mcp.json @@ -0,0 +1,8 @@ +{ + "mcpServers": { + "webull": { + "type": "http", + "url": "https://api.webull.com/mcp" + } + } +}