Cursor plugin specification and official plugins
TypeScript
feat(third_party): add eToro Trading plugin
Minu Palaniappanbcf813a77958
diff --git a/.cursor-plugin/marketplace.json b/.cursor-plugin/marketplace.jsonindex 84709029..c7068f4a 100644--- a/.cursor-plugin/marketplace.json+++ b/.cursor-plugin/marketplace.json@@ -437,6 +437,11 @@"name": "coinbase","source": "third_party/coinbase","description": "Check balances, get quotes, and preview or place trades."+ },+ {+ "name": "etoro-trading",+ "source": "third_party/etoro-trading",+ "description": "View your eToro portfolio, balances, positions, and watchlists, research instruments and traders, and prepare and place trades."}]}diff --git a/README.md b/README.mdindex 6bac0060..32f2aedb 100644--- a/README.md+++ b/README.md@@ -88,6 +88,7 @@ Official Cursor plugins for popular developer tools, frameworks, and SaaS produc| `statsig` | [Statsig](third_party/statsig/) | Cursor | Integrations | Inspect and manage feature gates, experiments, dynamic configs, and metrics. || `robinhood` | [Robinhood](third_party/robinhood/) | Cursor | Integrations | View portfolios, positions, orders, watchlists, and market data, and trade in a Robinhood Agentic account. || `coinbase` | [Coinbase](third_party/coinbase/) | Cursor | Integrations | Check balances, get quotes, and preview or place trades. |+| `etoro-trading` | [eToro Trading](third_party/etoro-trading/) | Cursor | Integrations | View your eToro portfolio, balances, positions, and watchlists, research instruments and traders, and prepare and place trades. |Author values match each plugin’s `plugin.json` `author.name` (Cursor lists `[email protected]` in the manifest).## Repository structurediff --git a/third_party/etoro-trading/.cursor-plugin/plugin.json b/third_party/etoro-trading/.cursor-plugin/plugin.jsonnew file mode 100644index 00000000..fec29ba1--- /dev/null+++ b/third_party/etoro-trading/.cursor-plugin/plugin.json@@ -0,0 +1,37 @@+{+ "name": "etoro-trading",+ "displayName": "eToro Trading",+ "version": "1.0.0",+ "minClientVersions": {+ "cursor": "3.13.0"+ },+ "description": "View your eToro portfolio, balances, positions, and watchlists, research instruments and traders, and prepare and place trades.",+ "author": {+ "name": "Cursor",+ "email": "[email protected]"+ },+ "homepage": "https://api-portal.etoro.com/core/vibe-code/cursor",+ "repository": "https://github.com/cursor/plugins",+ "license": "MIT",+ "logo": "assets/logo.png",+ "keywords": [+ "etoro",+ "brokerage",+ "trading",+ "portfolio",+ "stocks",+ "crypto",+ "copy trading",+ "market data",+ "watchlists",+ "mcp"+ ],+ "category": "integrations",+ "tags": [+ "etoro",+ "finance",+ "trading",+ "mcp"+ ],+ "mcpServers": "./mcp.json"+}diff --git a/third_party/etoro-trading/CHANGELOG.md b/third_party/etoro-trading/CHANGELOG.mdnew file mode 100644index 00000000..f47c4eae--- /dev/null+++ b/third_party/etoro-trading/CHANGELOG.md@@ -0,0 +1,9 @@+# Changelog++All notable changes to this plugin will be documented here.++## 1.0.0 — initial release++- Added the `etoro-trading` MCP server pointing at eToro's hosted Streamable HTTP endpoint for the Public API (`https://mcp.public-api.etoro.com`).+- Auth uses OAuth with eToro user login (PKCE, dynamic client registration) — no API key or client ID to configure.+- Logo: eToro's official bull mark, from the logo eToro publishes for its Cursor marketplace listing, on a 192×192 tile.diff --git a/third_party/etoro-trading/LICENSE b/third_party/etoro-trading/LICENSEnew file mode 100644index 00000000..ca2bba77--- /dev/null+++ b/third_party/etoro-trading/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/etoro-trading/README.md b/third_party/etoro-trading/README.mdnew file mode 100644index 00000000..30e42b21--- /dev/null+++ b/third_party/etoro-trading/README.md@@ -0,0 +1,64 @@+# eToro Trading++Cursor plugin that connects agents to [eToro](https://api-portal.etoro.com/core/vibe-code/cursor) through eToro's official remote [Model Context Protocol](https://modelcontextprotocol.io/) server for the eToro Public API.++View your eToro portfolio, balances, positions, and watchlists, research instruments and traders, and prepare and place trades.++This plugin is for operating an eToro account from chat. For writing code against the eToro Public API, install eToro's own [`etoro`](https://cursor.com/marketplace/etoro) plugin instead, which ships API-building rules, skills, and a documentation search server.++## Install++1. Open **Cursor Settings → Plugins**.+2. Search for **eToro Trading**.+3. Click **Install**, then complete the eToro sign-in prompt.++Or run `/add-plugin etoro-trading` in chat.++## MCP++```json+{+ "mcpServers": {+ "etoro-trading": {+ "type": "http",+ "url": "https://mcp.public-api.etoro.com"+ }+ }+}+```++Auth is OAuth. Cursor prompts for eToro sign-in when the plugin connects — there is no client ID or API key to configure. Each user signs in with their own eToro account and consents to the scopes the connection may use; the `get-my-profile-and-scopes` tool shows which account is connected and which scopes were granted.++## Before you connect++You need an eToro account. The server operates on both **Demo** (virtual money) and **Real** accounts, and the same tools work against either, so confirm which account type a request targets before letting the agent place a trade.++## What agents can do++| Category | Capabilities |+| --- | --- |+| Portfolio | Full portfolio summary with totals and per-instrument P&L, balances across every account type (Trading, Cash, Crypto, Options, and others), current positions and pending orders including copy-trading mirrors, and closed-trade history |+| Trading | `prepare-trade` validates an order against live eligibility, quotes, costs, and available balance and returns a confirmation block; `place-trade` submits exactly that order and waits for the outcome. `prepare-close` / `place-close` do the same for closing a position |+| Research | Batch overview of up to 100 instruments (price, spread, performance, tradability), public profiles and performance of up to 100 traders for copy-trading research, and the user's watchlists |+| API access | Browse the Public API route catalog by tag or keyword, read any route's OpenAPI spec, and run read or write requests against any route |++The hosted runtime is the source of truth for tool names and schemas.++## Notes++- **You are responsible for every trade the agent places.** The server gates trades behind a short-lived confirmation token issued by `prepare-trade` / `prepare-close`, and its tool descriptions instruct the agent to show you the confirmation block and get explicit approval before each `place-*` or `execute-write` call. If you instruct the agent to act without asking, it can still place orders.+- Orders placed on a Real account are live. eToro recommends starting on a Demo account.+- `execute-write` can reach any state-changing route in the Public API, including transfers and social posts, not only trades.++## Docs++- Cursor integration guide: https://api-portal.etoro.com/core/vibe-code/cursor+- Agent skill and server overview: https://api-portal.etoro.com/core/ai-agents/etoro-skill+- API reference: https://api-portal.etoro.com/+- Server URL: https://mcp.public-api.etoro.com++Logo is eToro's official mark.++## License++MITdiff --git a/third_party/etoro-trading/assets/logo.png b/third_party/etoro-trading/assets/logo.pngnew file mode 100644index 00000000..9e708444Binary files /dev/null and b/third_party/etoro-trading/assets/logo.png differdiff --git a/third_party/etoro-trading/mcp.json b/third_party/etoro-trading/mcp.jsonnew file mode 100644index 00000000..6745d06a--- /dev/null+++ b/third_party/etoro-trading/mcp.json@@ -0,0 +1,8 @@+{+ "mcpServers": {+ "etoro-trading": {+ "type": "http",+ "url": "https://mcp.public-api.etoro.com"+ }+ }+}