Capital.com Public API MCP Server

Capital.com MCP Server

Model Context Protocol (MCP)-Server für die Capital.com Open API – ermöglicht LLM-gesteuerten Zugriff auf Ihr Capital.com-Handelskonto.

⚠️ Wichtiger Hinweis

Ihre Nutzung der Capital.com Public API und aller Drittanbieter-Tools, einschließlich KI-/LLM-basierter Tools, erfolgt auf eigenes Risiko. Capital.com ist ein reiner Ausführungsdienst (Execution-only) und unterstützt keine Drittanbieter-Software und übernimmt keine Verantwortung für sie oder ihre Ergebnisse. Nichts hier ist eine Anlageberatung. Sie sind allein für Ihre Handelsentscheidungen verantwortlich, einschließlich etwaiger Preisunterschiede, die durch Latenzzeiten von Drittanbieter-Tools entstehen, und müssen die geltenden Bedingungen und Gesetze einhalten.

Krypto-Derivate sind für Privatkunden, die bei der Capital Com (UK) Ltd registriert sind, nicht verfügbar.

• Beginnen Sie immer mit einem Demo-Konto, bevor Sie Live-Handel in Betracht ziehen
• Der Handel ist standardmäßig deaktiviert und erfordert eine explizite Konfiguration
• Alle Handelsvorgänge erfordern eine zweiphasige Ausführung (Vorschau → Bestätigung → Ausführung)
• Integrierte Risikokontrollen: Whitelists, Größenlimits, tägliche Orderobergrenzen
• Nutzung auf eigenes Risiko – die Autoren übernehmen keine Haftung für Handelsverluste

Bei weiteren Fragen/Klärungen lesen Sie bitte die FAQ: https://help.capitalccuk.com/hc/en-us/articles/34503231743506-How-to-set-up-the-Capital-com-MCP-Server

Schnellstart-Anleitung

Schritt 1: Capital.com-API-Anmeldedaten erhalten

1. Konto erstellen: Gehen Sie zu capital.com/trading/signup

   • Wählen Sie ein Demo-Konto zum Testen (empfohlen)
   • Bestätigen Sie Ihre E-Mail

2. 2FA aktivieren: Einstellungen > Sicherheit > Zwei-Faktor-Authentifizierung

   • Erforderlich, bevor API-Schlüssel generiert werden können

3. API-Schlüssel generieren: Einstellungen > API-Integrationen > Neuen Schlüssel generieren

   • Legen Sie ein Label fest (z. B. „MCP Server")
   • Legen Sie ein eigenes Passwort fest (dies ist NICHT Ihr Plattform-Passwort)
   • Speichern Sie den angezeigten API-Schlüssel (wird nur einmal angezeigt!)
   • Hinweis: API-Schlüssel sind handelsfähig; Capital.com bietet keine Nur-Lese-Schlüssel an

Schritt 2: Installieren und Konfigurieren

KI-geführte Installation: Öffnen Sie diesen Projektordner in einem KI-gestützten Editor (Claude Code, Cursor, Windsurf) und bitten Sie ihn, den Capital.com-MCP-Server zu installieren – er folgt INSTALL.md, um Sie durch die Einrichtung zu führen und die beste Methode für Ihre Umgebung auszuwählen.

Sie haben außerdem diese manuellen Installationsoptionen:

Option A: Installation mit einem Klick über das MCPB-Bundle (empfohlen)

Das Repository enthält ein vorgefertigtes capital-mcp.mcpb-Bundle – öffnen Sie es in Claude Desktop und Sie sind fertig, keine manuelle Konfigurationsbearbeitung erforderlich.

Schritte:

1. Klonen Sie das Repository:

   git clone https://github.com/capital-com-sv/capital-mcp.git
   cd capital-mcp
   

2. Öffnen Sie capital-mcp.mcpb in Claude Desktop (Doppelklick oder ziehen Sie es in die App).
3. Claude Desktop fordert Sie zur Eingabe der Anmeldedaten (API-Schlüssel, Kennung, Passwort) und der Handelssteuerung auf. Füllen Sie diese aus und klicken Sie auf Installieren.
4. Starten Sie Claude Desktop neu und verifizieren Sie, indem Sie fragen: „Welche Capital.com-Tools sind verfügbar?"

Option B: Manuelle Installation per Skript

Voraussetzungen: Python 3.10+ und Git müssen installiert sein.

• macOS: brew install python3 git
• Ubuntu/Debian: sudo apt install python3 python3-venv git
• Windows: python.org („Add to PATH" während der Installation aktivieren) + git-scm.com

Mac/Linux:

cd /path/to/capital-mcp
./install.sh

Windows (PowerShell):

cd C:\path\to\capital-mcp
pwsh install.ps1

Das Installationsskript erstellt eine virtuelle Umgebung, installiert Abhängigkeiten und gibt die MCP-Client-Konfiguration für Sie aus.

Bearbeiten Sie .env mit Ihren Anmeldedaten:

# Required
CAP_ENV=demo
CAP_API_KEY=your_generated_api_key_here
CAP_IDENTIFIER=your_email@example.com
CAP_API_PASSWORD=your_custom_api_password

# Trading controls (keep trading disabled until ready)
CAP_ALLOW_TRADING=false
CAP_ALLOWED_EPICS=

# Optional: enable later for real trading
# CAP_ALLOW_TRADING=true
# CAP_ALLOWED_EPICS=SILVER,GOLD,BTCUSD

Option C: Docker

Voraussetzungen: Docker muss installiert sein.

1. Erstellen Sie eine .env-Datei mit Ihren Anmeldedaten (siehe .env.example):

   CAP_ENV=demo
   CAP_API_KEY=your_api_key_here
   CAP_IDENTIFIER=your_email@example.com
   CAP_API_PASSWORD=your_custom_password
   CAP_ALLOW_TRADING=false
   

2. Starten Sie den Server:

   docker run -i --rm --env-file .env ghcr.io/capital-com-sv/capital-mcp:latest
   

Fehlerbehebung: Protokolle prüfen

Wenn Sie Probleme bei der Verwendung des MCP-Servers mit Claude Desktop oder anderen Clients haben, prüfen Sie die Protokolldateien:

macOS:

# View MCP server logs
tail -f ~/Library/Logs/Claude/mcp-server-capital-com.log

# Search for errors
grep -i error ~/Library/Logs/Claude/mcp-server-capital-com.log

Linux:

tail -f ~/.config/Claude/logs/mcp-server-capital-com.log

Windows:

Get-Content $env:APPDATA\Claude\logs\mcp-server-capital-com.log -Wait

---

Client-Integration

Für clientspezifische Konfigurationen (Claude Desktop, Claude Code, Cursor, Windsurf, Codex, Docker, benutzerdefinierte Clients) siehe USAGE.md – Client-Integration.

Verwendungsbeispiele

Beispielkonversation mit Claude Desktop

You: "Check my Capital.com session status"

Claude: I'll check your session status.
[Calls cap_session_status]
Response: {"ok": true, "data": {"env": "demo", "logged_in": false, ...}}

You're not currently logged in to the demo environment.

---

You: "Login to my Capital.com account"

Claude: I'll log you in.
[Calls cap_session_login]
Success! Logged in to account ID: ABC123

---

You: "Search for Bitcoin markets"

Claude: Searching for Bitcoin...
[Calls cap_market_search with search_term="Bitcoin"]
Found 5 markets:
- BTCUSD: Bitcoin vs US Dollar
- BTCEUR: Bitcoin vs Euro
- BTCGBP: Bitcoin vs British Pound
...

---

You: "Show me current positions"

Claude: Let me check your positions.
[Calls cap_trade_positions_list]
You have no open positions.

---

You: "Preview buying 1.0 SILVER"

Claude: I'll preview this trade. Note: Trading is currently DISABLED.
[Calls cap_trade_preview_position]
Preview failed: Trading is disabled (CAP_ALLOW_TRADING=false)

To enable trading, update your .env file:
CAP_ALLOW_TRADING=true
CAP_ALLOWED_EPICS=SILVER

Handelsausführungs-Workflow (wenn Handel aktiviert)

1. Preview the trade (validates everything, no side effects):
   "Preview buying 2.0 SILVER with stop at 24.50"
   → Returns preview_id

2. Review the preview results:
   - Normalized size (rounded to broker increments)
   - Risk checks (allowlist, size limits, daily limits)
   - Estimated entry price

3. Execute ONLY if all checks pass:
   "Execute position with preview_id [id], confirm=true"
   → Creates real position
   → Returns deal_reference
   → Polls for broker confirmation

4. Monitor:
   "Show my positions"
   "Close position [deal_id] with confirm=true"

Referenz der Umgebungsvariablen

Erforderlich

• CAP_ENV – Umgebung: demo oder live (Standard: Demo)
• CAP_API_KEY – API-Schlüssel von Capital.com
• CAP_IDENTIFIER – Anmelde-E-Mail
• CAP_API_PASSWORD – Eigenes Passwort für den API-Schlüssel

Risikokontrollen (empfohlen)

• CAP_ALLOW_TRADING – Handel aktivieren (Standard: false)
• CAP_ALLOWED_EPICS – Kommagetrennte Whitelist (z. B. „SILVER,GOLD,BTCUSD") oder „ALL" für uneingeschränkt
• CAP_MAX_POSITION_SIZE – Maximale Positionsgröße (Standard: 1,0)
• CAP_MAX_WORKING_ORDER_SIZE – Maximale Ordergröße (Standard: 1,0)
• CAP_MAX_OPEN_POSITIONS – Maximale gleichzeitige Positionen (Standard: 3)
• CAP_MAX_ORDERS_PER_DAY – Tägliches Orderlimit (Standard: 20)
• CAP_REQUIRE_EXPLICIT_CONFIRM – confirm=true erforderlich (Standard: true)
• CAP_DRY_RUN – Alle Handelsausführungen blockieren (Standard: false)

Optional

• CAP_DEFAULT_ACCOUNT_ID – Standardkonto nach der Anmeldung
• CAP_HTTP_TIMEOUT_S – HTTP-Timeout (Standard: 15)
• CAP_LOG_LEVEL – Protokollebene: DEBUG, INFO, WARNING, ERROR (Standard: INFO)

MCP-Funktionen

38 Tools in 6 Kategorien, 7 Workflow-Prompts und 4 schreibgeschützte Ressourcen.

Kategorie	Tools	Beschreibung
Sitzung	4	Anmeldung, Abmeldung, Status, Keep-Alive
Marktdaten	6	Suche, Details, Preise, Stimmung, Navigation
Konto	6	Konten auflisten, Einstellungen, Aktivitäts-/Transaktionsverlauf, Demo-Aufladung
Handel	13	Vorschau, Ausführung, Positionen schließen; offene Orders auflisten/stornieren/ändern; Bestätigungen
Watchlists	6	Watchlists erstellen, auflisten, abrufen, löschen; Märkte hinzufügen/entfernen
Streaming	3	Echtzeitkurse, Alerts, Portfolio-P&L über WebSocket

Prompt	Beschreibung
market_scan	Eine Watchlist auf Handelsbedingungen prüfen
trade_proposal	Einen Trade mit risikobasierter Positionsgröße planen (nur Vorschau)
execute_trade	Einen zuvor in der Vorschau geprüften Trade ausführen
position_review	Offene Positionen und Exposure analysieren (schreibgeschützt)
live_price_monitor	Echtzeit-Kursverfolgung mit Bewegungsalerts (WebSocket)
real_time_alerts	Bedingte Preisniveau-Alerts (WebSocket)
live_portfolio_monitor	Live-Portfolio-P&L-Dashboard (WebSocket)

Ressource	Beschreibung
cap://status	Serverzustand, Sitzungsstatus, Ratenlimits
cap://risk-policy	Risikomanagement-Konfiguration und Validierungsebenen
cap://allowed-epics	Handels-Whitelist-Konfiguration
cap://market-cache/{epic}	Zwischengespeicherte Marktdetails (Live-Abruf)

Vollständige Details, Parameter und Beispiele finden Sie in USAGE.md.

Handelsausführungsprozess

Verbindliche zweistufige Ausführung

Alle Operationen mit Seiteneffekten verwenden einen strengen Vorschau-→-Ausführungs-Ablauf:

1. Vorschau: Trade gegen Broker-Regeln + lokale Risikorichtlinie validieren

   • Gibt preview_id mit normalisierter Anfrage + Risikoprüfungen zurück
   • Keine Seiteneffekte, schreibgeschützte Validierung

2. Ausführen: Trade mit preview_id übermitteln

   • Führt kritische Prüfungen erneut aus
   • Erfordert confirm=true, wenn CAP_REQUIRE_EXPLICIT_CONFIRM=true
   • Fragt Broker-Bestätigung ab
   • Erhöht den täglichen Orderzähler

Risikokontrollen

• Whitelist: Nur EPICs in CAP_ALLOWED_EPICS können gehandelt werden
• Größenlimits: Maximale Positions-/Ordergröße wird durchgesetzt
• Positionslimits: Maximale offene Positionen zu jeder Zeit
• Tägliche Limits: Maximale Orders pro Tag
• Größennormalisierung: Rundet auf Broker-Minimum/-Maximum/-Schrittweite
• Trockenlaufmodus: Blockiert alle Ausführungen, wenn aktiviert

Dokumentation

• Verwendungsanleitung: USAGE.md – Umfassende Verwendungsanleitung mit Beispielen
• Capital.com-API-Referenz: https://open-api.capital.com/
• Capital.com-API-Postman-Sammlung: https://github.com/capital-com-sv/capital-api-postman

Lizenz

MIT

Datenschutzrichtlinie

Der Capital.com-MCP-Server läuft lokal auf Ihrem Rechner und kommuniziert direkt mit der Capital.com Public API unter Verwendung der von Ihnen bereitgestellten Anmeldedaten. Er wird nicht als gehosteter Dienst betrieben und verfügt über keine eigenen Server.

Datenerfassung

Der MCP-Server erfasst oder speichert keine Daten. Er fungiert als lokale Brücke zwischen Ihrem KI-Client und der Capital.com Public API.

Datennutzung und -speicherung

Alle während einer Sitzung ausgetauschten Daten werden im Arbeitsspeicher Ihres lokalen Rechners verarbeitet und verworfen, wenn die Sitzung endet. Der MCP-Server schreibt keine Daten auf die Festplatte. Hinweis: Ihr KI-Client kann Daten, die durch ihn geleitet werden, gemäß seiner eigenen Datenschutzrichtlinie verarbeiten, protokollieren oder speichern – diese sollten Sie separat prüfen.

Weitergabe an Dritte

Der MCP-Server gibt keine Daten an Dritte weiter. Daten fließen nur zwischen Ihrer lokalen Umgebung und der Capital.com Public API, vorbehaltlich der eigenen Datenschutzrichtlinie von Capital.com.

Datenaufbewahrung

Der MCP-Server speichert keine Daten. Sitzungsdaten existieren nur für die Dauer der Sitzung im Arbeitsspeicher.

API-Anmeldedaten

Die von Ihnen bereitgestellten API-Anmeldedaten werden in Ihrer lokalen Umgebung gespeichert und verwaltet. Sie sind für deren angemessene Sicherung verantwortlich.

Kontakt

Bei datenschutzbezogenen Fragen zu Ihrem Capital.com-Konto oder zur Verarbeitung Ihrer Daten durch Capital.com lesen Sie die Capital.com-Datenschutzrichtlinie oder kontaktieren Sie support@capital.com.

Haftungsausschluss – Nutzung der Capital.com Public API mit Drittanbieter-Tools

Drittanbieter-Integration

Diese Seite beschreibt, wie Clients die Capital.com Public API mit Drittanbieter-Software, -Tools oder -Integrationen verbinden können, einschließlich solcher, die auf künstlicher Intelligenz oder großen Sprachmodellen („LLMs") basieren. Jede solche Drittanbieter-Software, jedes solche Tool oder jede solche Integration ist unabhängig von Capital.com und kein Bestandteil der Dienste von Capital.com. Capital.com kontrolliert, entwickelt oder unterstützt keine Drittanbieter-Software und übernimmt keine Haftung für deren Funktionalität, Ausgaben oder Ergebnisse, die aus ihrer Nutzung entstehen. Jegliche Nutzung von Drittanbieter-Tools oder -Integrationen in Verbindung mit der Capital.com Public API erfolgt vollständig auf eigenes Risiko. Sie sind dafür verantwortlich, die Bedingungen, Datenschutzrichtlinien und Datenverarbeitungspraktiken jedes Drittanbieter-Tools zu prüfen, das Sie verwenden möchten.

Nutzung der Public API

Ihre Nutzung der Capital.com Public API erfolgt vollständig nach eigenem Ermessen und auf eigenes Risiko. Capital.com stellt die Public API zu Informations- und Handelszwecken bereit, empfiehlt, unterstützt oder fördert jedoch keine bestimmte Nutzung, Integration oder Handelsstrategie. Sie sind allein dafür verantwortlich, wie Sie auf die API zugreifen und sie nutzen, einschließlich der Parameter aller übermittelten Orders, der Konfiguration aller verbundenen Tools oder Systeme und der Interpretation aller empfangenen Daten. Capital.com übernimmt keine Haftung für Verluste oder unbeabsichtigte Ergebnisse, die aus Ihrer Nutzung der API entstehen, sei es direkt oder über Drittanbieter-Tools. Die Verfügbarkeit, Funktionalität und Spezifikationen der API können jederzeit ohne vorherige Ankündigung geändert, ratenbegrenzt, ausgesetzt oder eingestellt werden. Ihre Nutzung der Public API unterliegt den Allgemeinen Geschäftsbedingungen und den Bedingungen für elektronischen Handel von Capital.com, die Sie vor der Nutzung der API sorgfältig lesen sollten.

Execution-only-Dienst und keine Anlageberatung

Capital.com erbringt seine Dienste auf Execution-only-Basis. Der Handel mit Finanzinstrumenten ist mit erheblichem Verlustrisiko verbunden. Nichts auf dieser Seite, in der Public API oder in Drittanbieter-Software oder -Integrationen stellt eine Anlageberatung, eine persönliche Empfehlung oder eine Aufforderung zum Kauf oder Verkauf von Finanzinstrumenten dar. Dies gilt auch für Ausgaben, Signale, Vorschläge oder Analysen, die von KI-, LLM-basierten oder anderen automatisierten Tools generiert werden. Alle Handelsentscheidungen, einschließlich automatisierter oder algorithmischer Aktivitäten, erfolgen auf eigenes Risiko und bleiben Ihre alleinige Verantwortung. Capital.com kontrolliert die Ausgaben von Drittanbieter-KI- oder LLM-basierten Tools, die mit der Public API verbunden sind, nicht und kann nicht garantieren, dass solche Tools keine Inhalte generieren, die als Anlageberatung oder persönliche Empfehlung ausgelegt werden könnten. Solche Ausgaben werden nicht von oder im Namen von Capital.com bereitgestellt und sollten nicht als Beratung herangezogen werden.

Risiken des automatisierten und algorithmischen Handels

Die Nutzung der Public API in Verbindung mit automatisierten oder algorithmischen Handelstools birgt zusätzliche Risiken, einschließlich, aber nicht beschränkt auf: schnelle Ausführung von Aufträgen ohne menschliche Überprüfung oder Eingriff; Systemfehler, Softwarefehler oder Konnektivitätsprobleme; Ausführung zu Preisen, die erheblich von den erwarteten abweichen; und unbeabsichtigte oder fehlerhafte Aufträge, die aus falsch konfigurierten Tools oder Parametern resultieren. Capital.com ist nicht verantwortlich für Verluste, die aus solchen Risiken oder aus der Interaktion zwischen seinen Systemen und Drittanbieter-Tools entstehen. Frühere Wertentwicklungen und alle von automatisierten Tools generierten Ausgaben sind kein Indikator für zukünftige Ergebnisse.

Wo KI- oder LLM-basierte Tools verwendet werden, um Marktdaten oder Preisinformationen abzurufen, kann es zu einer Verzögerung zwischen dem vom Tool mitgeteilten Preis und dem Preis kommen, zu dem ein daraus resultierender Auftrag ausgeführt wird. Alle über die Public API platzierten Aufträge werden als Marktaufträge ausgeführt. Der Ausführungspreis kann daher von jedem Preis abweichen, der zum Zeitpunkt einer Anfrage angezeigt wird. Capital.com ist bestrebt, eine bestmögliche Ausführung gemäß seinen Verpflichtungen zu erreichen; wir übernehmen keine Haftung für Preisunterschiede, die aus Latenzzeiten resultieren, die auf Drittanbieter-Tools oder Systeme außerhalb seiner Kontrolle zurückzuführen sind.

Verbotene Nutzung

Die Nutzung der Public API und aller verbundenen Tools darf nicht dazu verwendet werden, die Capital.com-Plattform zu manipulieren, Preise oder Latenzzeiten auszunutzen, Marktmissbrauch zu betreiben oder einen unfairen Vorteil zu erlangen. Capital.com behält sich das Recht vor, den API-Zugriff und/oder Ihr Konto einzuschränken, zu sperren oder zu beenden, wenn es vernünftigerweise der Ansicht ist, dass ein solcher Missbrauch stattgefunden hat oder wahrscheinlich stattfinden wird. Kunden dürfen Dritten nicht gestatten, eine diskretionäre Kontrolle über ihr Konto auszuüben.

Ihre Verantwortlichkeiten

Sie sind dafür verantwortlich, dass Ihre Nutzung der Capital.com-Plattform, der Public API und aller Drittanbieter-Tools oder Integrationen den Allgemeinen Geschäftsbedingungen von Capital.com, den Bedingungen für elektronischen Handel sowie allen geltenden Gesetzen und Vorschriften in Ihrer Rechtsordnung entspricht. Sie sollten sorgfältig abwägen, ob automatisierte Handelstools für Ihre Umstände, Erfahrung und Risikotoleranz geeignet sind, bevor Sie sie verwenden. Capital.com empfiehlt dringend, dass Sie alle automatisierten Tools oder Integrationen gründlich mit einem Demo-Konto testen, bevor Sie sie mit einer Live-Handelsumgebung verbinden.