convez.ai
MCP Server
pdhimate

etoro-mcp-connector

pdhimate/etoro-mcp-connector

Ver no GitHub
InicialPluginScore · de 0 a 100

Unofficial read-only Claude Desktop connector (MCP server) for the eToro public API: portfolio, balances, market data.

Instalação

$npx convez-ai pdhimate/etoro-mcp-connector

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
0
Forks
0
Acompanhando
0
Saúde
42%
Último commit
há 5 meses
Versão
v0.1.0
Issues abertas
0
Contribuidores
1

README

A tradução para o português deste README ainda está na fila.

eToro Portfolio Connector for Claude (Unofficial, read-only)

A Claude Desktop extension (MCP server) that connects Claude to your eToro account through eToro's official public API. Ask Claude about your portfolio, P&L, balances, watchlists, live prices, and price history.

This is a read-only connector: it can view your account and market data but cannot place, close, or cancel any trades — there are no trade-execution tools at all. (A trading-capable version is kept on the with-trading git branch.)

Disclaimer: This is an unofficial, community-built connector. It is not affiliated with, endorsed by, or supported by eToro. Nothing it produces is financial advice.

Features

All tools are read-only and work with a Read-permission eToro key:

ToolWhat it does
get_account_infoAccount identity, API key scopes, connector configuration
get_portfolio_summaryEquity, available cash, used margin, current P&L, per-instrument exposure
get_positionsOpen positions (entry rate, amount, units, leverage, SL/TP) with instrument names
get_pnlUnrealized P&L per position with current close rates
get_balancesCash balances across eToro account types (real account only; not available in demo mode)
get_trade_historyClosed trades: profit, fees, open/close rates and times
search_instrumentsFind stocks, ETFs, crypto, currencies, indices, commodities
get_quotesLive bid/ask for up to 100 instruments
get_price_historyOHLCV candles, 1-minute to 1-week intervals
get_watchlistsYour watchlists and the instruments they contain
check_trade_eligibilityAllowed leverage, minimum amounts, SL/TP limits per instrument (informational)
get_order_statusStatus of an order you previously submitted via the eToro app or website

Both real and demo (virtual) eToro accounts are supported — flip Demo mode in the settings and use a Demo-environment key.

Getting your eToro API keys

  1. Log in to etoro.com (your account must be verified).
  2. Go to Settings → Trading → API Key Management and click Create New Key.
  3. Choose:
    • Environment: Real or Demo — a key works for exactly one environment.
    • Permissions: Read is all this connector needs.
    • Optionally an IP whitelist and an expiration date.
  4. Confirm via SMS, then copy both values from the Generated Keys list:
    • API key (public key, sent as x-api-key)
    • User key (private key, sent as x-user-key)

Recommendation: a Read key is sufficient — this connector never trades, so there is no reason to give it a Write key.

Installation (Claude Desktop)

  1. Download etoro-mcp-connector.mcpb from the releases page (or build it yourself, below).
  2. Double-click the file, or in Claude Desktop go to Settings → Extensions → Install Extension… and pick it.
  3. Enter your API key and User key, and toggle Demo mode if your key is for the Demo environment. Keys are stored in your operating system's keychain.
  4. Ask Claude something like "What's in my eToro portfolio right now?"

Building from source

Requires Node.js ≥ 18.

npm install
npm run build      # compiles TypeScript to dist/
npm run smoke      # boots the server over stdio and verifies the tools

# Build the installable bundle (build + smoke + prune dev deps + pack):
npm run pack:mcpb  # produces etoro-mcp-connector.mcpb

Security notes

  • Your keys are sent only to eToro's official API endpoint, https://public-api.etoro.com, as the x-api-key / x-user-key headers eToro's documentation specifies. There is no other network traffic, no telemetry, and no local persistence of any account data.
  • This connector is read-only: every tool is annotated readOnlyHint and the server contains no order placement, closing, or cancellation code. Even a Write-permission key cannot trade through it. For extra safety, use a Read-only key.
  • eToro rate-limits keys to roughly 60 requests per minute; the connector retries politely on 429 responses.

Privacy Policy

This extension runs entirely on your machine. It does not collect, store, or transmit any personal data to anyone other than eToro itself (your API requests) — see PRIVACY.md for the full policy.

License

MIT

Ver o original no GitHub

Bom para

Relacionados