etoro-mcp

Servidor MCP remoto de solo lectura que expone los datos de la cartera de eToro (posiciones, P&L, saldos, watchlists e historial de operaciones cerradas) como herramientas, para poder registrarlo como un conector personalizado en Claude (el chat de claude.ai, no solo desde un editor). Se ejecuta en Cloudflare Workers sobre Streamable HTTP.

Esta es una herramienta personal y de un solo usuario. Nunca coloca, modifica ni cierra una operación: solo envía solicitudes GET a la API de eToro.

Requisitos previos

• Node.js (LTS reciente)

• Una cuenta de Cloudflare (para wrangler dev y el despliegue posterior)

• Credenciales de la API de eToro (x-api-key / x-user-key) de api-portal.etoro.com

Instala las dependencias:

npm install

Acerca de Wrangler

Este proyecto se despliega en Cloudflare Workers, y Wrangler es la CLI oficial de Cloudflare para compilar, probar y desplegar Workers. Ya está incluido como devDependency, así que npm install lo incorpora; no se necesita instalación aparte. Se usa mediante npx wrangler ... o el script npm run dev que aparece más abajo. Comandos relevantes:

• wrangler dev — ejecuta el servidor localmente, simulando el runtime de Workers (esto es lo que invoca npm run dev).

• wrangler deploy — publica el código en la red periférica de Cloudflare bajo una URL pública real.

• wrangler secret put <NAME> — sube de forma segura un secreto (por ejemplo, tu clave de API de eToro o el token de portador del conector) al Worker desplegado, sin incluirlo nunca en el repositorio.

• wrangler.toml — el archivo de configuración de Workers de este repositorio (build/name/routes).

Antes de que wrangler deploy o wrangler secret put funcionen, inicia sesión una vez:

wrangler login

Related MCP server: eToro Portfolio Connector

Desarrollo local (wrangler dev)

1. Copia el archivo de entorno de ejemplo y rellena los valores reales:

   cp .dev.vars.example .dev.vars

2. En .dev.vars, define:

   • ETORO_API_KEY / ETORO_USER_KEY — tus credenciales de la API de eToro.

   • CONNECTOR_AUTH_TOKEN — un token de portador secreto que protege el endpoint /mcp de este conector (sin relación con las credenciales de eToro anteriores). Genera uno con:

     openssl rand -hex 32

   .dev.vars está en el .gitignore: nunca lo incluyas en el repositorio.

3. Inicia el servidor local de desarrollo de Workers:

   npm run dev

4. Cada solicitud a /mcp debe incluir el token de portador:

   Authorization: Bearer <CONNECTOR_AUTH_TOKEN from .dev.vars>

Las solicitudes que no incluyan el encabezado, o que presenten un token incorrecto, reciben un 401. Si CONNECTOR_AUTH_TOKEN no está definido en absoluto, el servidor aplica la política de fallo cerrado y rechaza todas las solicitudes en lugar de permitir el acceso no autenticado.

Ejecutar pruebas

npm test        # unit tests (node:test)
npm run typecheck

Desplegar y registrar como conector de Claude

El despliegue y el registro del conector son pasos manuales que realiza el operador (no se ejecutan como parte de la automatización de este repositorio):

1. Establece los secretos en el Worker desplegado (nunca los confirmes en el repositorio):

   wrangler secret put ETORO_API_KEY
   wrangler secret put ETORO_USER_KEY
   wrangler secret put CONNECTOR_AUTH_TOKEN

2. Despliega:

   wrangler deploy

   Esto publica el Worker y muestra su URL *.workers.dev (o una ruta personalizada, si está configurada).

3. Regístralo como conector personalizado en Claude:

   • En claude.ai, ve a Ajustes → Conectores → Añadir conector personalizado.

   • Introduce la URL /mcp del Worker desplegado.

   • Completa el paso de autenticación del conector, proporcionando el mismo CONNECTOR_AUTH_TOKEN que se definió antes mediante wrangler secret put.

4. Prueba de extremo a extremo: haz a Claude una pregunta real sobre la cartera en un chat normal (por ejemplo, «¿cuál es el P&L de mi cartera de eToro ahora mismo?») y confirma que llama a la herramienta adecuada y que devuelve datos en tiempo real.