FxSocket

oficial

Acceso de solo lectura a cuentas alojadas de MetaTrader 4 y MT5: saldos y patrimonio, posiciones abiertas y órdenes pendientes, historial de operaciones, búsqueda de símbolos, cotizaciones en vivo y velas.

¿Qué puedes hacer con FxSocket MCP?

  • Account overview — List every account the key can see, with platform, server, connection status, and balance or equity totals per currency.
  • Open exposure — Show open positions and pending orders across accounts, filtered by symbol or type, with floating profit, swap, and totals.
  • Trade history review — Summarize closed trades for a period up to 366 days, including win rate, net profit, best and worst trade, and per-symbol breakdown.
  • Symbol lookup — Find the broker's exact symbol name before requesting prices, since names like EURUSD vary by broker.
  • Live quotes and specs — Get bid, ask, and spread for up to 20 symbols, plus contract details like tick value, volume limits, swap rates, and sessions.
  • Price history — Pull OHLC candles for a symbol and timeframe, up to 500 bars per call, to describe a trend.

Servidor MCP alojado

npx add-mcp 'https://mcp.fxsocket.com/mcp'

Se instala en Claude Code, Codex, Cursor y más

Documentación

Servidor MCP de MetaTrader

Da a un agente de IA acceso de lectura a tus cuentas de MetaTrader 4 y MetaTrader 5. El servidor MCP de FxSocket permite que Claude, Cursor, VS Code y cualquier otro cliente de Model Context Protocol respondan preguntas sobre tu trading: balance y equity en todas las cuentas, qué está abierto ahora mismo, cómo fue el mes pasado, cotizaciones en vivo e historial de precios. Es de solo lectura. Ninguna herramienta puede colocar, modificar ni cerrar una orden.

URL del servidor https://mcp.fxsocket.com/mcp

1. Crea una clave de API de solo lectura

En la página de claves de API, crea una clave de solo lectura. Empieza por fxs_ro_, puede llamar a todas las herramientas de esta página y tampoco puede operar a través de ningún otro endpoint. Ponle un nombre y limítala a las cuentas que el agente debe ver, y el agente nunca sabrá que las demás existen. Tu clave completa fxs_live_ también funciona, pero un agente no tiene ningún uso para ella.

2. Conecta tu cliente

Los clientes que aceptan una URL de servidor remoto y una cabecera se conectan directamente. Los clientes que solo inician servidores locales, como Claude Desktop, usan la imagen de Docker.

claude mcp add --transport http fxsocket https://mcp.fxsocket.com/mcp \
  --header "X-API-Key: fxs_ro_xxx"
{
  "mcpServers": {
    "fxsocket": {
      "url": "https://mcp.fxsocket.com/mcp",
      "headers": { "X-API-Key": "fxs_ro_xxx" }
    }
  }
}
{
  "servers": {
    "fxsocket": {
      "type": "http",
      "url": "https://mcp.fxsocket.com/mcp",
      "headers": { "X-API-Key": "fxs_ro_xxx" }
    }
  }
}
{
  "mcpServers": {
    "fxsocket": {
      "command": "docker",
      "args": ["run", "-i", "--rm", "-e", "FXSOCKET_API_KEY", "fxsocket/mcp"],
      "env": { "FXSOCKET_API_KEY": "fxs_ro_xxx" }
    }
  }
}

Cualquier otro cliente funciona igual: apúntalo a https://mcp.fxsocket.com/mcp con la clave en una cabecera X-API-Key (también se acepta Authorization: Bearer), o ejecuta la imagen de Docker como servidor local.

Herramientas

Ocho herramientas, todas de solo lectura. Cada una está diseñada en torno a una pregunta en lugar de a un endpoint, así que «qué está abierto en todas mis cuentas» es una sola llamada que lee todos los terminales a la vez.

  • list_accounts: Todas las cuentas que la clave puede ver, con su id, alias, plataforma, servidor, login y estado de conexión, opcionalmente con balance, equity y totales por divisa. Los agentes la llaman primero.
  • get_account: Una cuenta completa: balance, equity, margen, nivel de margen y apalancamiento, ajustes de la cuenta como el nivel de stop-out, y el estado del terminal.
  • get_open_positions: Posiciones abiertas y órdenes pendientes en todas las cuentas, filtrables por símbolo y tipo, con beneficio flotante, swap y totales por divisa.
  • get_trade_history: Operaciones cerradas de un periodo (los últimos 7 días por defecto, hasta 366), con ganancias, pérdidas, tasa de acierto, beneficio neto, la mejor y la peor operación, y un desglose por símbolo.
  • search_symbols: El nombre exacto del símbolo del bróker. EURUSD es EURUSD.sd o EURUSDm en algunos brókers, así que los agentes lo consultan antes de pedir precios.
  • get_quotes: Bid, ask y spread en vivo para hasta 20 símbolos.
  • get_symbol_info: La especificación del contrato: dígitos, tamaño del contrato, valor del tick, límites de volumen, tasas de swap, comisiones y sesiones de trading.
  • get_price_history: Velas OHLC para un símbolo y una temporalidad, hasta 500 barras por llamada.

Qué puedes preguntar

  • «¿Cuál es mi equity total en todas las cuentas, por divisa?»
  • «¿Qué posiciones abiertas están en pérdidas ahora mismo, y por cuánto?»
  • «¿Cuál fue mi tasa de acierto en XAUUSD el mes pasado, y cuál fue mi peor operación?»
  • «Compara el spread de EURUSD en cada uno de mis brókers.»
  • «Extrae las últimas 200 velas H1 de GBPUSD y describe la tendencia.»

De solo lectura por diseño

El servidor no puede operar por lo que su código puede alcanzar, no por un ajuste: todas las herramientas leen del terminal y ninguna de ellas puede enviar una orden. Así, un agente confundido o manipulado sigue sin poder abrir, cambiar ni cerrar una posición.

El dinero se informa en la divisa de depósito de cada cuenta y nunca se suma entre divisas; las herramientas devuelven totales por divisa para que el modelo no tenga que hacer esa aritmética. Las horas son la hora del servidor del bróker, como en el resto de la API.

Límites: 60 solicitudes por minuto por usuario, hasta 50 cuentas y 300 filas de órdenes u operaciones en una respuesta. Los recuentos y los totales siempre abarcan todo; solo se recortan las listas de filas.

Ejecútalo localmente con Docker

La imagen fxsocket/mcp ejecuta el servidor como un proceso stdio local, para clientes que inician sus propios servidores. Es un pequeño relay, un único archivo Python sin dependencias, que pasa cada mensaje a mcp.fxsocket.com con tu clave. Las herramientas y tus datos siguen viniendo de FxSocket, así que la imagen nunca necesita actualizarse cuando cambian las herramientas. Publicada para amd64 y arm64.

FXSOCKET_API_KEY=fxs_ro_xxx docker run -i --rm -e FXSOCKET_API_KEY fxsocket/mcp

Docker Hub · Código fuente en GitHub (MIT)

Detalles del protocolo

  • Transporte: Streamable HTTP, solo POST, respuestas JSON. Sin estado, sin sesión que mantener viva.
  • Versiones del protocolo: 2026-07-28 (metadatos por solicitud, sin handshake) y 2025-03-26 hasta 2025-11-25 (el handshake initialize).
  • Autenticación: las mismas claves de API que la API de la plataforma, en X-API-Key o Authorization: Bearer.
  • Aún no compatible: los conectores web de claude.ai y ChatGPT, que inician sesión con OAuth en lugar de una cabecera. Claude Desktop funciona hoy mediante la imagen de Docker.