What is Etoroportfoliomcp

etoroPortfolioMCP is a server that provides tools for interacting with eToro’s public API endpoints using the Model Context Protocol (MCP). It allows users to fetch portfolio information, instrument details, and perform searches on instruments.

Use cases

Use cases include retrieving user portfolios for analysis, obtaining detailed information about financial instruments, and implementing autocomplete search features for trading applications.

How to use

To use etoroPortfolioMCP, first install the dependencies with ‘npm install’. Then, start the development server using ‘npm run dev’ or build for production with ‘npm run build’ and start the production server using ‘npm start’.

Key features

Key features include fetching a user’s portfolio by username, retrieving instrument details by IDs, and searching for instruments using name prefixes. It also handles CORS limitations by processing requests server-side.

Where to use

etoroPortfolioMCP can be used in financial applications, trading platforms, and investment analysis tools that require access to eToro’s data and functionalities.

eToro MCP Server

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

1. Fetch a user’s portfolio using their username
2. Look up instrument details by IDs
3. Search for instruments by name prefix (autocomplete)

Getting Started

1. Install dependencies:

   npm install
   

2. Start the development server:

   npm run dev
   

3. Build for production:

   npm run build
   

4. 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"}'