Etoroportfoliomcp

🚀 eToro MCP Server

This server offers MCP (Model Context Protocol) tools to interact with eToro's public API endpoints. It enables you to:

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

🚀 Quick Start

📦 Installation

Install the dependencies:

npm install

💻 Development

Start the development server:

npm run dev

🏭 Production

Build the project for production:

npm run build

Start the production server:

npm start

✨ Features

fetch_etoro_portfolio

This tool fetches an eToro user's portfolio by their username. Internally, it automatically converts the username to a Customer ID (CID).

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

Some of the eToro API endpoints have CORS restrictions. These requests should be made from a server - side environment. The tools in this server handle these requests on the server side to avoid CORS issues.

💻 Usage Examples

Basic Usage

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

Advanced Usage

Here is an 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"}'