FxSocket
offiziellNur-Lese-Zugriff auf gehostete MetaTrader 4- und MT5-Konten: Kontostände und Eigenkapital, offene Positionen und ausstehende Orders, Handelshistorie, Symbolsuche, Live-Kurse und Candles.
Was kann man mit FxSocket MCP machen?
- Kontoübersicht — Listen Sie jedes Konto auf, das der Schlüssel sehen kann, mit Plattform, Server, Verbindungsstatus und Saldo- oder Eigenkapitalsummen pro Währung.
- Offene Risikopositionen — Zeigen Sie offene Positionen und ausstehende Orders über Konten hinweg an, gefiltert nach Symbol oder Typ, mit schwebendem Gewinn, Swap und Summen.
- Überprüfung des Handelsverlaufs — Fassen Sie geschlossene Trades für einen Zeitraum von bis zu 366 Tagen zusammen, einschließlich Gewinnrate, Nettogewinn, bester und schlechtester Trade sowie Aufschlüsselung pro Symbol.
- Symbolsuche — Finden Sie den exakten Symbolnamen des Brokers, bevor Sie Preise anfordern, da Namen wie EURUSD je nach Broker variieren.
- Live-Kurse und Spezifikationen — Rufen Sie Bid, Ask und Spread für bis zu 20 Symbole ab, plus Kontraktdetails wie Tick-Wert, Volumenlimits, Swap-Sätze und Sitzungen.
- Preisverlauf — Rufen Sie OHLC-Kerzen für ein Symbol und einen Zeitrahmen ab, bis zu 500 Balken pro Aufruf, um einen Trend zu beschreiben.
Gehosteter MCP-Server
npx add-mcp 'https://mcp.fxsocket.com/mcp'Installiert in Claude Code, Codex, Cursor und mehr
Dokumentation
MetaTrader MCP-Server
Gib einem KI-Agenten Lesezugriff auf deine MetaTrader-4- und MetaTrader-5-Konten. Der FxSocket MCP-Server ermöglicht Claude, Cursor, VS Code und jedem anderen Model-Context-Protocol-Client, Fragen zu deinem Trading zu beantworten: Guthaben und Equity über alle Konten hinweg, was gerade offen ist, wie der letzte Monat lief, Live-Kurse und Kurshistorie. Er ist schreibgeschützt. Kein Tool kann eine Order platzieren, ändern oder schließen.
Server-URL https://mcp.fxsocket.com/mcp
1. Einen schreibgeschützten API-Schlüssel erstellen
Erstelle auf der API-Key-Seite einen schreibgeschützten Schlüssel. Er beginnt mit fxs_ro_, kann jedes Tool hier aufrufen und kann auch über keinen anderen Endpunkt handeln. Gib ihm einen Namen und beschränke ihn auf die Konten, die der Agent sehen soll – dann erfährt der Agent nie, dass die anderen existieren. Dein vollständiger fxs_live_-Schlüssel funktioniert ebenfalls, aber ein Agent hat keinen Nutzen davon.
2. Client verbinden
Clients, die eine Remote-Server-URL und einen Header akzeptieren, verbinden sich direkt. Clients, die nur lokale Server starten, wie Claude Desktop, verwenden das Docker-Image.
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" }
}
}
}
Jeder andere Client funktioniert genauso: Richte ihn auf https://mcp.fxsocket.com/mcp mit dem Schlüssel in einem X-API-Key-Header (Authorization: Bearer wird ebenfalls akzeptiert) oder starte das Docker-Image als lokalen Server.
Tools
Acht Tools, alle schreibgeschützt. Jedes ist um eine Frage herum gestaltet statt um einen Endpunkt, sodass „was ist über meine Konten hinweg offen“ ein einziger Aufruf ist, der alle Terminals gleichzeitig liest.
list_accounts: Jedes Konto, das der Schlüssel sehen kann, mit ID, Nickname, Plattform, Server, Login und Verbindungsstatus, optional mit Guthaben, Equity und Summen pro Währung. Agenten rufen es zuerst auf.get_account: Ein Konto vollständig: Guthaben, Equity, Margin, Margin-Level und Hebel, Kontoeinstellungen wie das Stop-out-Level sowie der Zustand des Terminals.get_open_positions: Offene Positionen und Pending-Orders über alle Konten hinweg, filterbar nach Symbol und Typ, mit schwebendem Gewinn, Swap und Summen pro Währung.get_trade_history: Geschlossene Trades für einen Zeitraum (standardmäßig die letzten 7 Tage, bis zu 366), mit Gewinnen, Verlusten, Gewinnrate, Nettogewinn, dem besten und schlechtesten Trade und einer Aufschlüsselung nach Symbol.search_symbols: Der exakte Symbolname des Brokers. EURUSD ist bei manchen Brokern EURUSD.sd oder EURUSDm, daher schlagen Agenten ihn nach, bevor sie Kurse anfragen.get_quotes: Live-Bid, Ask und Spread für bis zu 20 Symbole.get_symbol_info: Die Kontraktspezifikation: Digits, Kontraktgröße, Tick-Wert, Volumengrenzen, Swap-Sätze, Kommissionen und Handelssitzungen.get_price_history: OHLC-Kerzen für ein Symbol und einen Zeitrahmen, bis zu 500 Bars pro Aufruf.
Was du fragen kannst
- „Wie hoch ist meine gesamte Equity über alle Konten, pro Währung?“
- „Welche offenen Positionen sind gerade im Minus, und um wie viel?“
- „Wie war meine Gewinnrate bei XAUUSD letzten Monat, und was war mein schlechtester Trade?“
- „Vergleiche den EURUSD-Spread bei jedem meiner Broker.“
- „Hole die letzten 200 H1-Kerzen von GBPUSD und beschreibe den Trend.“
Schreibgeschützt durch Design
Der Server kann nicht handeln, weil sein Code keinen Zugriff darauf hat – nicht wegen einer Einstellung: Jedes Tool liest vom Terminal, und keines kann eine Order senden. Selbst ein verwirrter oder manipulierter Agent kann daher keine Position eröffnen, ändern oder schließen.
Geldbeträge werden in der Einzahlungswährung des jeweiligen Kontos angegeben und nie über Währungen hinweg addiert; die Tools liefern Summen pro Währung, damit das Modell diese Arithmetik nicht selbst durchführen muss. Zeiten sind Broker-Server-Zeit, wie überall sonst in der API.
Limits: 60 Anfragen pro Minute pro Nutzer, bis zu 50 Konten und 300 Order- oder Trade-Zeilen in einer Antwort. Anzahlen und Summen umfassen immer alles; nur die Zeilenlisten werden gekürzt.
Lokal mit Docker ausführen
Das fxsocket/mcp-Image führt den Server als lokalen stdio-Prozess aus, für Clients, die ihre Server selbst starten. Es ist ein kleines Relay, eine einzige Python-Datei ohne Abhängigkeiten, das jede Nachricht mit deinem Schlüssel an mcp.fxsocket.com weiterleitet. Die Tools und deine Daten kommen weiterhin von FxSocket, daher muss das Image nie aktualisiert werden, wenn sich Tools ändern. Veröffentlicht für amd64 und arm64.
FXSOCKET_API_KEY=fxs_ro_xxx docker run -i --rm -e FXSOCKET_API_KEY fxsocket/mcp
Docker Hub · Quellcode auf GitHub (MIT)
Protokolldetails
- Transport: Streamable HTTP, nur POST, JSON-Antworten. Zustandslos, ohne Session, die am Leben gehalten werden muss.
- Protokollversionen: 2026-07-28 (Metadaten pro Anfrage, kein Handshake) und 2025-03-26 bis 2025-11-25 (der
initialize-Handshake). - Authentifizierung: dieselben API-Schlüssel wie bei der Plattform-API, in
X-API-KeyoderAuthorization: Bearer. - Noch nicht unterstützt: die Web-Connectoren in claude.ai und ChatGPT, die sich per OAuth statt per Header anmelden. Claude Desktop funktioniert heute über das Docker-Image.