# eToro MCP Server (npm · etoro-mcp-server)

Connect AI assistants to eToro for portfolio analysis, market research, and trading.

- Trust score: 76/100 (medium)
- Change this week: +52
- Registry status: active
- Liveness: live
- Owner verified: no
- Last scored: 2026-08-03

## Components

- npm · `etoro-mcp-server`: 76/100 (this document), [markdown](https://verifymcp.io/servers/gabrielcerutti-etoro-mcp-server/etoro-mcp-server.md), [page](https://verifymcp.io/servers/gabrielcerutti-etoro-mcp-server/etoro-mcp-server)

## Channel facts

- Registry: `npm`
- Package: `etoro-mcp-server`
- Version: `1.1.4`
- Transport: `stdio`

## Trust breakdown

How this component scores in each security and reliability category. Every signal is checked automatically from public evidence about the published package, including repeated runs of it in an isolated sandbox, and we only credit what we can confirm. Scores are 0–100 per category. Scoring method: https://verifymcp.io/docs/scoring (what has changed: https://verifymcp.io/docs/scoring/changelog)

Scored 2026-08-03.

- **Supply Chain Security**: 87/100
  - No malware found by supply-chain analysis.
  - Only part of the dependency tree could be resolved (95 of 96), so this covers what we could see, not the whole tree.
  - No install/post-install scripts declared.
  - Only part of the dependency tree could be resolved (95 of 96), so this covers what we could see, not the whole tree.
- **Provenance & Transparency**: 97/100
  - Source repository is publicly reachable at the declared URL.
  - Cryptographically verified build provenance (signed, bound to gabrielcerutti/etoro-mcp-server).
  - Clear OSI-approved license (MIT).
  - Actively maintained (last published 97 days ago).
  - Disclosure check failed: no security disclosure policy was found in the source repository.
- **Schema Quality & AI Usability**: 77/100
  - AI-judged instruction clarity (excellent).
  - Tool/resource definitions use about 1989 tokens (~56/item across 35 items; 35 tools + 0 resources), lean.
  - Usage-examples check failed: none of the tools include examples.
- **Stability & Change Management**: 0/100
  - Stability not yet verified: not enough scan history yet (needs a 30-day window).
- **Tool Coverage**: 100/100
  - 100% of tools have a non-trivial description (not blank, and not just the tool's name).
  - 100% of tool parameters carry a description.
- **Capabilities**: 100/100
  - Implements a supported MCP spec version (2025-11-25); the latest is 2026-07-28.

**Unverified: 1 category.** A category scored 0 because we could not verify it: a data source with nothing on this package, evidence we could not reach, or a check we could not run. We only credit what we can confirm.

## Install

### Claude

```bash
claude mcp add gabrielcerutti-etoro-mcp-server -- npx -y etoro-mcp-server
```

### Codex

```bash
codex mcp add gabrielcerutti-etoro-mcp-server -- npx -y etoro-mcp-server
```

### opencode

```json
{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "gabrielcerutti-etoro-mcp-server": {
      "type": "local",
      "command": [
        "npx",
        "-y",
        "etoro-mcp-server"
      ],
      "enabled": true
    }
  }
}
```

### OpenClaw

```bash
openclaw mcp add gabrielcerutti-etoro-mcp-server --command npx --arg -y --arg etoro-mcp-server
```

### Hermes

```yaml
mcp_servers:
  gabrielcerutti-etoro-mcp-server:
    command: "npx"
    args: ["-y", "etoro-mcp-server"]
```

### Other

```json
{
  "mcpServers": {
    "gabrielcerutti-etoro-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "etoro-mcp-server"
      ]
    }
  }
}
```

## Changelog

Every change recorded for this component, newest first. Days that predate change tracking, or that we cannot explain, say so: "we were watching and nothing happened" and "we were not watching" are different claims.

### 2026-08-02 (score 76, +40)

- [security improvement] Install scripts: unverified → pass
- [security improvement] Provenance: unverified → pass
- [security improvement] Known CVEs: unverified → partial
- [security] Stability: Stability not yet verified: not enough scan history yet (needs a 30-day window).
- [security] The attested source repository moved: gabrielcerutti/etoro-mcp-server
- [functional improvement] MCP protocol: unverified → pass
- [functional improvement] Schema quality: unverified → excellent
- [functional improvement] License: unverified → pass
- [functional improvement] Dependency health: unverified → partial
- [functional improvement] Maintenance: unverified → pass
- [functional] Licence: MIT

### 2026-08-01 (score 36, +8)

- [functional] We updated how we score, so this day's move reflects our rubric, not a change to the server

### 2026-07-31 (score 28, −18)

- [security regression] Malware scan: pass → unverified

### 2026-07-28 (score 46, +22)

- [functional improvement] Tool coverage: unverified → 100
- [functional] First check of Schema quality: unverified
- [functional] First check of Tool coverage: 100
- [functional] First check of Schema quality: fail
- [functional] First check of Schema quality: pass

### 2026-07-27 (score 24)

First indexed and scored.

## MCP tools (35)

### `etoro_search_instruments` (~112 tokens)

Search instruments

Search eToro instruments (stocks, crypto, ETFs, etc.) by keyword or exact ticker.

Input parameters:

- `exactSymbol` (boolean): If true, match by exact ticker symbol (e.g. 'AAPL') instead of free-text
- `page` (integer): Page number (default 1)
- `pageSize` (integer): Results per page (default 10, max 100)
- `query` (string, required): Search keyword (e.g. 'AAPL', 'Bitcoin', 'Tesla')

### `etoro_get_instruments` (~39 tokens)

Get instrument details

Get full details for one or more instruments by their IDs.

Input parameters:

- `instrumentIds` (array, required): Array of instrument IDs (1–100)

### `etoro_get_instrument_types` (~28 tokens)

List instrument types

List all instrument types eToro supports (stocks, crypto, ETFs, etc.).

### `etoro_get_industries` (~21 tokens)

List industries

List all industry classifications used for stock instruments.

### `etoro_get_exchanges` (~19 tokens)

List exchanges

List all stock exchanges eToro supports.

### `etoro_get_candles` (~100 tokens)

Get OHLCV candles

Fetch OHLCV candle data for an instrument. Useful for technical analysis and historical price research.

Input parameters:

- `count` (integer): Number of candles to return (default 10, max 1000)
- `direction` (string): Sort: 'asc' (oldest first) or 'desc' (newest first). Default: desc
- `instrumentId` (integer, required): Instrument ID
- `period` (string, required): Candle period

### `etoro_get_closing_prices` (~20 tokens)

Get daily closing prices

Fetch historical closing prices across all instruments.

### `etoro_get_rates` (~38 tokens)

Get live rates

Get live bid/ask rates for one or more instruments.

Input parameters:

- `instrumentIds` (array, required): Array of instrument IDs (1–100)

### `etoro_open_position` (~170 tokens)

Open position

Open a new position on an instrument. Provide exactly one of `amount` (USD) or `units` (share/coin count). Respects the configured trading mode (demo or real).

Input parameters:

- `amount` (number): Investment amount in USD (mutually exclusive with `units`)
- `instrumentId` (integer, required): Instrument ID to trade
- `isBuy` (boolean, required): true = Buy/Long, false = Sell/Short
- `leverage` (integer): Leverage multiplier (1, 2, 5, 10, etc.; max 400)
- `stopLossRate` (number): Stop-loss price
- `takeProfitRate` (number): Take-profit price
- `units` (number): Number of units / shares / coins (mutually exclusive with `amount`)

### `etoro_close_position` (~101 tokens)

Close position

Close an open position (fully or partially). Pass `unitsToDeduct` to close only part of the position; omit it to close fully.

Input parameters:

- `instrumentId` (integer): Instrument ID of the position (optional; will be looked up from portfolio if omitted)
- `positionId` (integer, required): The position ID to close
- `unitsToDeduct` (number): Number of units to close for partial close. Omit for full close.

### `etoro_place_limit_order` (~120 tokens)

Place limit order

Place a limit / entry order that executes when the market reaches the specified price.

Input parameters:

- `amount` (number, required): Investment amount in USD
- `instrumentId` (integer, required): Instrument ID
- `isBuy` (boolean, required): true = Buy/Long, false = Sell/Short
- `leverage` (integer): Leverage multiplier (default 1)
- `rate` (number, required): Limit price at which the order should execute
- `stopLossRate` (number): Stop-loss price
- `takeProfitRate` (number): Take-profit price

### `etoro_cancel_order` (~34 tokens)

Cancel pending order

Cancel a pending limit or market order before it executes.

Input parameters:

- `orderId` (integer, required): The order ID to cancel

### `etoro_get_orders` (~28 tokens)

List pending orders

List all pending orders (limit orders, entry orders, etc.) for the current account.

### `etoro_get_portfolio` (~55 tokens)

Get portfolio + P&L

Get the current account's portfolio with P&L: credit, open positions (with current rates), unrealized P&L, total invested, exposure summary, and longest-held position. Respects demo/real mode.

### `etoro_get_trade_history` (~95 tokens)

Get closed-trade history

Fetch the history of closed trades (entry/exit, P&L, fees, duration). Supports pagination. Primary data source for performance analysis, win-rate, and drawdown research.

Input parameters:

- `minDate` (string, required): Start date (YYYY-MM-DD). Required by the API.
- `page` (integer): Page number (default 1)
- `pageSize` (integer): Results per page (default 100)

### `etoro_get_instrument_feed` (~72 tokens)

Get instrument feed

Get the social feed (posts, discussions) for a specific instrument.

Input parameters:

- `instrumentId` (integer, required): Instrument ID
- `offset` (integer): Number of posts to skip (default 0)
- `take` (integer): Number of posts to retrieve (default 20, max 100)

### `etoro_get_user_feed` (~76 tokens)

Get user feed

Get the social feed (posts, discussions) for a specific user by their eToro username.

Input parameters:

- `offset` (integer): Number of posts to skip (default 0)
- `take` (integer): Number of posts to retrieve (default 20, max 100)
- `username` (string, required): eToro username

### `etoro_create_post` (~54 tokens)

Create feed post

Create a new post on the eToro social feed. Optionally tag an instrument.

Input parameters:

- `content` (string, required): Post content / text
- `instrumentId` (integer): Optional instrument ID to tag in the post

### `etoro_create_comment` (~50 tokens)

Comment on a post

Add a comment to an existing post on the eToro social feed.

Input parameters:

- `content` (string, required): Comment content / text
- `postId` (string, required): ID of the post to comment on

### `etoro_get_watchlists` (~20 tokens)

List watchlists

Get all watchlists for the current user.

### `etoro_create_watchlist` (~39 tokens)

Create watchlist

Create a new watchlist with the given name.

Input parameters:

- `name` (string, required): Name for the new watchlist (max 100 chars)

### `etoro_delete_watchlist` (~33 tokens)

Delete watchlist

Delete a watchlist by its ID.

Input parameters:

- `watchlistId` (integer, required): Watchlist ID to delete

### `etoro_rename_watchlist` (~50 tokens)

Rename watchlist

Rename an existing watchlist.

Input parameters:

- `name` (string, required): New name for the watchlist (max 100 chars)
- `watchlistId` (integer, required): Watchlist ID to rename

### `etoro_add_watchlist_items` (~51 tokens)

Add items to watchlist

Add one or more instruments to an existing watchlist.

Input parameters:

- `instrumentIds` (array, required): Instrument IDs to add (1–100)
- `watchlistId` (integer, required): Watchlist ID

### `etoro_remove_watchlist_item` (~44 tokens)

Remove item from watchlist

Remove an instrument from a watchlist.

Input parameters:

- `instrumentId` (integer, required): Instrument ID to remove
- `watchlistId` (integer, required): Watchlist ID

### `etoro_set_default_watchlist` (~37 tokens)

Set default watchlist

Mark a watchlist as the user's default.

Input parameters:

- `watchlistId` (integer, required): Watchlist ID to set as default

### `etoro_get_curated_lists` (~22 tokens)

Get curated lists

Get eToro's curated / featured instrument lists.

### `etoro_get_public_watchlists` (~38 tokens)

Get user's public watchlists

Get publicly shared watchlists from a specific user.

Input parameters:

- `userId` (integer, required): User ID whose public watchlists to retrieve

### `etoro_get_user_profile` (~31 tokens)

Get user profile

Get an eToro user's public profile by username.

Input parameters:

- `username` (string, required): eToro username

### `etoro_get_user_performance` (~67 tokens)

Get user performance

Get a user's trading performance (returns, risk score). Pass `period` for time-windowed performance; omit for lifetime/default summary.

Input parameters:

- `period` (string): Optional performance period. Omit for the default lifetime summary.
- `username` (string, required): eToro username

### `etoro_get_user_trades` (~54 tokens)

Get user trade info

Get a user's trade info (averages, win/loss stats) for a specific period.

Input parameters:

- `period` (string, required): Period to retrieve trade info for
- `username` (string, required): eToro username

### `etoro_get_user_portfolio` (~35 tokens)

Get user public portfolio

Get a user's live public portfolio holdings (instruments, allocation).

Input parameters:

- `username` (string, required): eToro username

### `etoro_discover_users` (~154 tokens)

Discover popular investors

Discover popular investors / traders on eToro filtered by performance, risk, and popularity.

Input parameters:

- `gainMax` (number): Maximum gain percentage
- `gainMin` (number): Minimum gain percentage
- `maxDailyRiskScoreMax` (number): Max daily risk score (1–10, lower = safer)
- `maxMonthlyRiskScoreMax` (number): Max monthly risk score (1–10, lower = safer)
- `page` (integer): Page number (default 1)
- `pageSize` (integer): Results per page (default 20)
- `period` (string, required): Performance period to filter by
- `popularInvestor` (boolean): Filter to popular investors (eligible for copy) only

### `etoro_get_current_user` (~49 tokens)

Get authenticated user identity

Get the identity of the currently authenticated user: Global Customer ID (GCID), real account CID, demo account CID. Useful for self-referential queries and for resolving your own username.

### `etoro_get_copiers` (~33 tokens)

Get my copiers

Get information about users currently copying the authenticated user's portfolio (country, club, copy duration, amount category).

## Diagnostics

Captured diagnostic sections: Provenance, Dependencies. The full working is on the page: https://verifymcp.io/servers/gabrielcerutti-etoro-mcp-server/etoro-mcp-server#diagnostics

## Score history

- 2026-08-03: 76
- 2026-08-02: 76
- 2026-08-01: 36
- 2026-07-31: 28
- 2026-07-30: 46
- 2026-07-28: 46
- 2026-07-27: 24

## Links

- npm package: https://www.npmjs.com/package/etoro-mcp-server
- Socket report: https://socket.dev/npm/package/etoro-mcp-server
- Repository: https://github.com/gabrielcerutti/etoro-mcp-server
- Changelog RSS feed: https://verifymcp.io/servers/gabrielcerutti-etoro-mcp-server/etoro-mcp-server/changelog.xml
- Changelog JSON feed: https://verifymcp.io/servers/gabrielcerutti-etoro-mcp-server/etoro-mcp-server/changelog.json
- HTML version of this page: https://verifymcp.io/servers/gabrielcerutti-etoro-mcp-server/etoro-mcp-server