eToro MCP Server
Connect any MCP-compatible AI assistant (Claude, Cursor, and others) to your eToro account for portfolio analysis, market research, and trading.
에이전트 강화
게시자의 자체 명령입니다. PlugMCP 엔드포인트가 아닙니다.
Host a copy with our keys and logs.
npx -y [email protected]Claude Code에는 로컬 명령용 설치 링크가 없습니다. 아래 명령을 복사해 터미널에서 실행합니다.
ETORO_API_KEY=<secret> ETORO_USER_KEY=<secret> ETORO_TRADING_MODE=<value> claude mcp add io.github.gabrielcerutti-etoro-mcp-server -- npx -y etoro-mcp-server@1.1.4터미널에서 실행합니다.
{ "mcpServers": { "io.github.gabrielcerutti-etoro-mcp-server": { "command": "npx", "args": [ "-y", "[email protected]" ], "env": { "ETORO_API_KEY": "<secret>", "ETORO_USER_KEY": "<secret>", "ETORO_TRADING_MODE": "<value>" } } }}claude_desktop_config.json
원격 URL인가요, 내 컴퓨터에서 실행하는 명령인가요? 두 설치 방식의 차이
PlugMCP에서 실행
A new server you create. It is not this listing's official endpoint. Use the publisher install when you want their URL and their credentials.
실행MCP server wrapping the eToro public API, exposing 35 tools for AI assistants (Claude Desktop, Cursor, Claude Code, etc.). Built for investment research and portfolio analysis — assess positions, research instruments and themes, vet popular investors for copy-trading, backtest DCA strategies against historical data. Trading is fully supported, but use care: letting an AI agent place real-money orders is genuinely risky, and you should treat it as such.
The server is built around research workflows first. The examples below show real multi-tool conversations — the assistant chains several etoro_* calls together to answer a single question. Numbers are representative; actual responses draw from live eToro data.
The assistant calls etoro_get_portfolio to pull your open positions, then etoro_get_instruments to resolve instrument IDs to names and sectors, and etoro_get_rates for live prices. It assembles a full snapshot from the raw data.
You: How is my portfolio doing? Break it down by sector and flag any trouble spots.
Assistant: I pulled your portfolio (98 open positions), resolved each instrument, and fetched live rates. Here's the picture:
- Cash: $22,265 • Invested: $45,782 • Positions: 98 open
Sector breakdown:
Trouble spot: Your tech sleeve is 38% of invested capital and concentrated in 5 mega-caps. A single sector drawdown hits hard — consider whether the ETF overlap (QQQ, SOXX) is intentional diversification or accidental doubling-down.
Tools used: etoro_get_portfolio → etoro_get_instruments → etoro_get_rates
Search is keyword-based — etoro_search_instruments finds instruments by ticker or company name, then you chain etoro_get_instruments for full details and etoro_get_candles for price history.
You: Pull up NVDA — I want the current price and a weekly chart for the last month.
Assistant: Searching for "NVDA" and pulling candle data:
- NVIDIA Corporation (NVDA) — InstrumentID 1545
- Live rate: Bid $208.14 / Ask $208.40
- Exchange: NASDAQ • Type: Stock • Sector: Semiconductors
Weekly candles (last 5 weeks):
NVDA rallied +27% off the March low ($162.95 → $208.26), with each weekly candle printing a higher low. Momentum is strong but the move is getting extended.
Tools used: etoro_search_instruments → etoro_get_instruments → etoro_get_rates → etoro_get_candles
Vet popular investors using real public data. The assistant calls etoro_get_user_profile for identity and stats, then etoro_get_user_performance for the full yearly return history.
You: Vet user jeppekirkbonde for a long-term copy allocation. I want the honest risk picture.
Assistant: Here's what the data says on jeppekirkbonde:
- Name: Jeppe Kirk Bonde • PI Level: 6 (highest tier)
- Copiers: 25,000+ • AUM: $200M+
- Background: MSc Finance, Copenhagen Business School
Year-by-year performance (real data):
Average annual return: +30.7% across 13 full years. Three down years (2014, 2018, 2022) with a max drawdown of −19.2% in the 2022 tech selloff.
What you should know:
- This is a concentrated, long-only US tech strategy. The +150.9% in 2017 and +81.1% in 2016 are outliers — don't expect those every year.
- Down years are real: 2022 cost −19.2%. If you can't stomach a 20% paper loss, this isn't the right copy.
- 25K+ copiers and $200M+ AUM means his moves have market impact in smaller names. Slippage is a factor.
Reasonable for multi-year capital if you accept the volatility. Not appropriate for money you need inside 18 months.
Tools used: etoro_get_user_profile → etoro_get_user_performance
The full watchlist lifecycle — create, populate, rename, and curate — all through natural language.
You: Create a "Semiconductor" watchlist and add NVDA, AMD, ASML, TSM, and AVGO to it.
Assistant: Done:
- Created watchlist "Semiconductor" (ID: 48291)
- Searched and resolved all 5 tickers to instrument IDs
- Added: NVDA (1545), AMD (2842), ASML (5765), TSM (3901), AVGO (6192)
Your watchlists now:
Tools used: etoro_create_watchlist → etoro_search_instruments → etoro_add_watchlist_items → etoro_get_watchlists
Use etoro_get_candles to pull years of OHLCV data, then simulate a dollar-cost averaging strategy — no orders placed, pure research.
You: Backtest a $500/month DCA into QQQ over the last 3 years. What would I have today?
Assistant: Pulling weekly QQQ candles (156 weeks) and simulating $500 on the first trading day of each month:
- Total invested: $18,000 (36 months × $500)
- Units accumulated: ~38.2 QQQ
- Current value: $25,365 (at $664.01/share)
- Gain: +$7,365 (+40.9% on invested capital)
- Approx. IRR: ~12.8%/year
Worst stretch: Nov 2022 – Mar 2023, paper drawdown of −22% on the accumulated stack. You bought through it — those discounted shares are now your biggest winners.
No orders placed. This is research only.
Tools used: etoro_get_candles → etoro_get_rates (for current price)
Combine portfolio data with the assistant's general knowledge to get a risk assessment tied to your actual holdings.
You: My portfolio is heavy on tech. Flag any risks from this week's macro calendar.
Assistant: Your tech exposure totals ~$17,400 (38% of invested capital) across GOOG, META, MSFT, NVDA, AMZN and the SOXX/QQQ ETFs. This week's watch-list:
- Wed — CPI print (core consensus +0.3% MoM). A hot number re-prices rate-cut odds → tech multiples compress first.
- Thu — Fed speakers (Williams, Waller). Hawkish language strengthens USD, pressuring mega-cap international revenue.
- Fri — NVDA earnings (after close). Binary event for your largest single-stock position.
What this means for you:
- A hot CPI + hawkish Fed combo could knock 3–5% off your tech sleeve short-term.
- NVDA earnings will drive ~8% of your portfolio's week-over-week change. Know your thesis before it prints.
Tools used: etoro_get_portfolio → etoro_get_instruments → etoro_get_rates (+ assistant's macro knowledge)
⚠️ Letting an AI execute real-money trades is risky. The same natural-language interface that makes research fast also makes it easy to misinterpret intent — a typo, an ambiguous number, a stale context from earlier in the conversation. Mitigations: start in
ETORO_TRADING_MODE=demo, use read-only API keys for anything that doesn't need write access, and require explicit confirmation in your conversation before anyrealorder.
All examples above are research-only. When you're ready to execute, the same interface places orders. Orders always respect the configured ETORO_TRADING_MODE (demo for paper, real for live).
You: Buy $500 of NVDA at market.
Assistant: Confirmed — opening a market position:
- Instrument: NVDA (1545)
- Amount: $500
- Rate: $208.40 (ask)
- Mode:
demoPosition opened — ID
3418072. This is a demo trade, no real money involved.
Full trading coverage includes: open position by amount or units (etoro_open_position), close or partially close (etoro_close_position), limit/entry orders (etoro_place_limit_order), cancel pending orders (etoro_cancel_order), and listing pending orders (etoro_get_orders).
MCP servers are designed to be composed. The eToro server handles portfolio data, live rates, candles, and trading — but an AI assistant can call tools from multiple servers in a single conversation, filling in the gaps that no single API covers.
With eToro + a financial data server (e.g. Financial Datasets, Alpha Vantage, or similar):
You: Do any of my open positions have earnings this week? Flag the ones I should watch.
Assistant: Pulling your portfolio from eToro (98 positions), then checking the earnings calendar:
- NVDA — reports Thursday after close. Your position: $4,200 (9.2% of invested). This is a binary event — expect ±8% move.
- GOOGL — reports Tuesday after close. Your position: $3,100 (6.8%). Consensus is +12% YoY revenue; ad revenue mix is the swing factor.
- UNH — reported Monday pre-market (already priced in). Beat on EPS, slight miss on membership growth.
The rest of your holdings have no earnings this week. Your biggest event risk is NVDA Thursday — it's your largest single-stock position.
This isn't possible with the eToro server alone — it knows your positions but not the earnings calendar. The financial data server knows the calendar but not your portfolio. Together, the assistant connects both.
Just add multiple servers to your MCP config — the assistant sees all tools from all servers:
{
"mcpServers": {
"etoro": {
"command": "npx",
"args": ["-y", "etoro-mcp-server"],
"env": {
"ETORO_API_KEY": "your-api-key",
"ETORO_USER_KEY": "your-user-key",
"ETORO_TRADING_MODE": "demo"
}
},
"financial-data": {
"command": "npx",
"args": ["-y", "financial-datasets-mcp-server"],
"env": {
"FINANCIAL_DATASETS_API_KEY": "your-key"
}
},
"news": {
"command": "npx",
"args": ["-y", "tavily-mcp-server"],
"env": {
"TAVILY_API_KEY": "your-key"
}
}
}
}
The assistant will automatically chain tools across servers when a question requires it — no extra wiring needed.
Download the latest .mcpb file from the Releases page and drag it into Claude Desktop:
Extensions → drag etoro-{version}.mcpb into the window
You'll be prompted for your API Key, User Key, and trading mode. That's it.
[!TIP] Get your keys at eToro → Settings → Trading → Create New Key. Choose your environment (Demo or Real) and the permissions you need (Read or Write).
Add this to your client's MCP config — it'll launch the server from the published npm package on demand, no local install needed:
{
"mcpServers": {
"etoro": {
"command": "npx",
"args": ["-y", "etoro-mcp-server"],
"env": {
"ETORO_API_KEY": "your-api-key",
"ETORO_USER_KEY": "your-user-key",
"ETORO_TRADING_MODE": "demo"
}
}
}
}
For Claude Code, the equivalent CLI command:
claude mcp add etoro \
-e ETORO_API_KEY=your-api-key \
-e ETORO_USER_KEY=your-user-key \
-e ETORO_TRADING_MODE=demo \
-- npx -y etoro-mcp-server
Pin a specific version with [email protected] in the args if you want stability over auto-updates.
If you want to hack on the server locally, clone the repo and build:
npm install
npm run build
Then point your MCP client at the built file (dist/index.js):
claude mcp add etoro-mcp \
-e ETORO_API_KEY=your-api-key \
-e ETORO_USER_KEY=your-user-key \
-e ETORO_TRADING_MODE=demo \
-- node /path/to/etoro-mcp/dist/index.js
Or in claude_desktop_config.json / equivalent:
{
"mcpServers": {
"etoro-mcp": {
"command": "node",
"args": ["/path/to/etoro-mcp/dist/index.js"],
"env": {
"ETORO_API_KEY": "your-api-key",
"ETORO_USER_KEY": "your-user-key",
"ETORO_TRADING_MODE": "demo"
}
}
}
}
This server is listed on the MCP Registry under the name io.github.gabrielcerutti/etoro-mcp-server. The registry is the public index of MCP servers — think of it as a package registry for AI tools, analogous to what npm is for JavaScript libraries. MCP-compatible clients use it to discover and install servers programmatically without users having to hand-copy configuration.
Each tagged release of this repository is auto-published to the registry by GitHub Actions (via OIDC), so the entry always tracks the latest npm version.
Trading mode: demo routes all trading calls through eToro's virtual account. Set to real only when you're ready to trade with real money.
[!WARNING]
trading_modemust match the environment of your API key. A demo key used withrealmode (or vice versa) will cause authentication errors.
All tools are prefixed with etoro_ for namespace isolation when composed with other MCP servers.
This project is an unofficial, community-built integration. It is not affiliated with, endorsed by, or supported by eToro. Use it at your own risk.
real mode. Verify every order before confirming, and understand that AI assistants can misinterpret intent.ETORO_TRADING_MODE=demo and only switch to real after you're confident in your setup.Contributions are welcome — bug reports, feature requests, and pull requests.
The DeepWiki page gives an auto-generated overview of the codebase architecture — useful starting point before diving in.
mainnpm install && npm run build to verify your changes compilenpm test to make sure existing tests passMIT — use it, fork it, build on it.
Connect AI assistants to eToro for portfolio analysis, market research, and trading.
{ "mcpServers": { "io.github.gabrielcerutti-etoro-mcp-server": { "command": "npx", "args": [ "-y", "[email protected]" ], "env": { "ETORO_API_KEY": "<secret>", "ETORO_USER_KEY": "<secret>", "ETORO_TRADING_MODE": "<value>" } } }}도구
아직 도구 목록이 없습니다. 원격 서버는 첫 상태 확인 후에 도구 목록이 생깁니다.
FAQ
이 페이지에서 Cursor, Claude Desktop, Claude Code 또는 VS Code용 stdio 설정을 복사합니다. PlugMCP 프록시가 아니라 게시자의 설치 방식을 사용합니다.
게시자가 등록한 환경 변수: ETORO_API_KEY, ETORO_USER_KEY, ETORO_TRADING_MODE.
EToro MCP Server은(는) stdio를 통해 로컬에서 실행됩니다.
마지막 확인: 2026-11-09. Connect AI assistants to eToro for portfolio analysis, market research, and trading.