eToro MCP Server

Instructions

Implementation Reference

• dist/index.js:141-181 (handler)

  The main handler function for the 'fetch_instrument_details' tool. It takes instrumentIds and fields, constructs a query to the eToro API, performs a GET request with specific headers to bypass CORS, parses the JSON response, and returns it as formatted text content.

  }, async (params) => {
      const { instrumentIds, fields } = params;
      try {
          const instrumentIdsString = instrumentIds.join(',');
          const fieldsString = fields.join(',');
          // This should be run server-side due to CORS limitations
          const response = await fetch(`https://www.etoro.com/sapi/instrumentsinfo/Instruments?internalInstrumentId=${instrumentIdsString}&fields=${fieldsString}`, {
              method: 'GET',
              headers: {
                  'accept': 'application/json, text/plain, */*',
                  'accept-language': 'en-US,en;q=0.9',
                  'cache-control': 'no-cache',
                  'pragma': 'no-cache',
                  'priority': 'u=1, i',
                  'sec-ch-ua': '"Not(A:Brand";v="99", "Google Chrome";v="133", "Chromium";v="133"',
                  'sec-ch-ua-mobile': '?0',
                  'sec-ch-ua-platform': '"Windows"',
                  'sec-fetch-dest': 'empty',
                  'sec-fetch-mode': 'cors',
                  'sec-fetch-site': 'same-origin',
                  'user-agent': 'Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/133.0.0.0 Safari/537.36',
              }
          });
          if (!response.ok) {
              throw new Error(`Failed to fetch instrument details: ${response.statusText}`);
          }
          const instrumentData = await response.json();
          return {
              content: [{
                      type: "text",
                      text: JSON.stringify(instrumentData, null, 2)
                  }],
          };
      }
      catch (error) {
          if (error instanceof Error) {
              throw new Error(`Failed to fetch instrument details: ${error.message}`);
          }
          throw error;
      }
  });

• dist/index.js:137-140 (schema)

  Zod schema defining the input parameters for the tool: an array of instrument IDs (required) and an array of fields (optional with default).

  instrumentIds: z.array(z.number()).describe("List of instrument IDs to fetch details for"),
  fields: z.array(z.string())
      .default(['displayname', 'threeMonthPriceChange', 'oneYearPriceChange', 'lastYearPriceChange'])
      .describe("Fields to include in the response")

• dist/index.js:136-136 (registration)

  The registration of the 'fetch_instrument_details' tool on the MCP server using server.tool(name, description, schema, handler).

  server.tool("fetch_instrument_details", "Fetch details for a list of eToro instruments", {