FxSocket

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

Serveur MCP MetaTrader

Donnez à un agent IA un accès en lecture à vos comptes MetaTrader 4 et MetaTrader 5. Le serveur MCP FxSocket permet à Claude, Cursor, VS Code et à tout autre client Model Context Protocol de répondre à des questions sur votre trading : solde et équité sur l'ensemble des comptes, ce qui est ouvert en ce moment, comment s'est passé le mois dernier, cotations en direct et historique des prix. Il est en lecture seule. Aucun outil ne peut placer, modifier ou fermer un ordre.

URL du serveur https://mcp.fxsocket.com/mcp

1. Créer une clé API en lecture seule

Sur la page des clés API, créez une clé en lecture seule. Elle commence par fxs_ro_, peut appeler tous les outils présentés ici, et ne peut pas non plus trader via un autre point de terminaison. Nommez-la et limitez-la aux comptes que l'agent doit voir : l'agent n'apprendra jamais que les autres existent. Votre clé complète fxs_live_ fonctionne aussi, mais un agent n'en a aucun usage.

2. Connecter votre client

Les clients qui acceptent une URL de serveur distant et un en-tête se connectent directement. Les clients qui ne démarrent que des serveurs locaux, comme Claude Desktop, utilisent l'image 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" }
    }
  }
}

Tout autre client fonctionne de la même manière : pointez-le vers https://mcp.fxsocket.com/mcp avec la clé dans un en-tête X-API-Key (Authorization: Bearer est également accepté), ou exécutez l'image Docker comme serveur local.

Outils

Huit outils, tous en lecture seule. Chacun est conçu autour d'une question plutôt que d'un point de terminaison, de sorte que « qu'est-ce qui est ouvert sur l'ensemble de mes comptes » est un seul appel qui lit tous les terminaux à la fois.

• list_accounts : tous les comptes que la clé peut voir, avec leur id, surnom, plateforme, serveur, identifiant de connexion et état de connexion, et en option le solde, l'équité et les totaux par devise. Les agents l'appellent en premier.
• get_account : un compte en détail : solde, équité, marge, niveau de marge et levier, paramètres du compte comme le niveau de stop-out, et état du terminal.
• get_open_positions : positions ouvertes et ordres en attente sur l'ensemble des comptes, filtrables par symbole et par type, avec profit flottant, swap et totaux par devise.
• get_trade_history : transactions clôturées sur une période (les 7 derniers jours par défaut, jusqu'à 366), avec gains, pertes, taux de réussite, profit net, meilleure et pire transaction, et une répartition par symbole.
• search_symbols : le nom exact du symbole chez le courtier. EURUSD est EURUSD.sd ou EURUSDm chez certains courtiers, les agents le recherchent donc avant de demander des prix.
• get_quotes : bid, ask et spread en direct pour jusqu'à 20 symboles.
• get_symbol_info : la spécification du contrat : décimales, taille du contrat, valeur du tick, limites de volume, taux de swap, commissions et sessions de trading.
• get_price_history : bougies OHLC pour un symbole et une unité de temps, jusqu'à 500 barres par appel.

Ce que vous pouvez demander

• « Quelle est mon équité totale sur l'ensemble de mes comptes, par devise ? »
• « Quelles positions ouvertes sont dans le rouge en ce moment, et de combien ? »
• « Quel a été mon taux de réussite sur XAUUSD le mois dernier, et quelle a été ma pire transaction ? »
• « Compare le spread EURUSD chez chacun de mes courtiers. »
• « Récupère les 200 dernières bougies H1 de GBPUSD et décris la tendance. »

En lecture seule par conception

Le serveur ne peut pas trader en raison de ce que son code peut atteindre, et non d'un paramètre : chaque outil lit depuis le terminal et aucun d'entre eux ne peut envoyer d'ordre. Ainsi, un agent confus ou manipulé ne peut toujours pas ouvrir, modifier ou fermer une position.

Les montants sont exprimés dans la devise de dépôt de chaque compte et ne sont jamais additionnés entre devises ; les outils renvoient des totaux par devise pour que le modèle n'ait pas à faire cette arithmétique. Les heures sont celles du serveur du courtier, comme partout ailleurs dans l'API.

Limites : 60 requêtes par minute et par utilisateur, jusqu'à 50 comptes et 300 lignes d'ordres ou de transactions dans une réponse. Les comptages et les totaux couvrent toujours l'ensemble ; seules les listes de lignes sont tronquées.

L'exécuter localement avec Docker

L'image fxsocket/mcp exécute le serveur comme un processus stdio local, pour les clients qui démarrent eux-mêmes leurs serveurs. C'est un petit relais, un seul fichier Python sans dépendances, qui transmet chaque message à mcp.fxsocket.com avec votre clé. Les outils et vos données proviennent toujours de FxSocket, l'image n'a donc jamais besoin d'être mise à jour lorsque les outils changent. Publiée pour amd64 et arm64.

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

Docker Hub · Source sur GitHub (MIT)

Détails du protocole

• Transport : Streamable HTTP, POST uniquement, réponses JSON. Sans état, sans session à maintenir en vie.
• Versions du protocole : 2026-07-28 (métadonnées par requête, sans handshake) et 2025-03-26 à 2025-11-25 (le handshake initialize).
• Authentification : les mêmes clés API que l'API de la plateforme, dans X-API-Key ou Authorization: Bearer.
• Pas encore pris en charge : les connecteurs web de claude.ai et ChatGPT, qui se connectent via OAuth plutôt que par un en-tête. Claude Desktop fonctionne dès aujourd'hui grâce à l'image Docker.