financedeveloper-tools

eToro MCP Server▌

by shlomico-tr

eToro MCP Server: Model Context Protocol tools to access eToro API endpoints—fetch portfolios, search instruments, get i

Provides Model Context Protocol tools for interacting with eToro's public API endpoints, allowing users to fetch portfolios, look up instrument details, and search for instruments while handling CORS restrictions.

github stars

★ 5

GitHub npm

Bypasses CORS restrictionsNo direct API key required

best for

/ Financial app developers integrating eToro data
/ Portfolio analysis and tracking tools
/ Trading bots and automated investment systems

capabilities

/ Fetch eToro user portfolios by username
/ Look up trading instrument details by ID
/ Search for financial instruments by name
/ Handle CORS-restricted API calls server-side

what it does

Connects to eToro's public API to fetch user portfolios, look up trading instrument details, and search for financial instruments. Handles CORS restrictions by running server-side.

about

eToro MCP Server is an official MCP server published by shlomico-tr that provides AI assistants with tools and capabilities via the Model Context Protocol. eToro MCP Server: Model Context Protocol tools to access eToro API endpoints—fetch portfolios, search instruments, get i It is categorized under finance, developer tools.

how to install

You can install eToro MCP Server in your AI client of choice. Use the install panel on this page to get one-click setup for Cursor, Claude Desktop, VS Code, and other MCP-compatible clients. This server runs locally on your machine via the stdio transport.

license

MIT

eToro MCP Server is released under the MIT license. This is a permissive open-source license, meaning you can freely use, modify, and distribute the software.

readme

eToro MCP Server

This server provides MCP (Model Context Protocol) tools for interacting with eToro's public API endpoints. It allows you to:

Fetch a user's portfolio using their username
Look up instrument details by IDs
Search for instruments by name prefix (autocomplete)

Getting Started

Install dependencies:
```
npm install
```
Start the development server:
```
npm run dev
```
Build for production:
```
npm run build
```
Start the production server:
```
npm start
```

Available Tools

fetch_etoro_portfolio

Fetches an eToro user's portfolio using their username. The tool automatically converts the username to a Customer ID (CID) internally.

Parameters:

username: The eToro username
authToken (optional): Authorization token for authenticated requests

fetch_instrument_details

Fetches details for a list of eToro instruments.

Parameters:

instrumentIds: List of instrument IDs to fetch details for
fields (optional): Fields to include in the response (defaults to displayname, threeMonthPriceChange, oneYearPriceChange, lastYearPriceChange)

search_instruments

Searches for eToro instruments by name prefix (autocomplete).

Parameters:

namePrefix: The prefix to search for in instrument names
fields (optional): Fields to include in the response (defaults to internalInstrumentId, displayname, internalClosingPrice)

CORS Limitations

Note that some of the eToro API endpoints have CORS restrictions and should be called from a server-side environment. The tools in this server handle these requests on the server side to avoid CORS issues.

Usage Example

The server exposes a REST API for accessing these tools, which can be called from any HTTP client:

GET /tools                          # List all available tools
GET /tools/:name/schema             # Get tool schema
POST /tools/:name/execute           # Execute a tool

Example of using the fetch_etoro_portfolio tool:

curl -X POST http://localhost:3000/tools/fetch_etoro_portfolio/execute \
  -H "Content-Type: application/json" \
  -d '{"username": "yoniasia"}'