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

Die 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 und unterstützt oder übernimmt keine Verantwortung für Drittanbieter-Software oder deren Ergebnisse. Nichts hier ist eine Anlageberatung. Sie sind allein für Ihre Handelsentscheidungen verantwortlich, einschließlich etwaiger Preisabweichungen durch Latenzzeiten von Drittanbieter-Tools, und müssen die geltenden Bedingungen und Gesetze einhalten.

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

• Beginnen Sie immer mit einem Demo-Konto, bevor Sie Live-Handel in Betracht ziehen
• Handel ist standardmäßig aktiviert und kann in der Konfiguration deaktiviert werden
• 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)
   • Verifizieren Sie Ihre E-Mail

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

   • Erforderlich vor der Generierung von API-Schlüsseln

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: Installation & Konfiguration

KI-gestützte 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 auch diese manuellen Installationsoptionen:

Option A: Ein-Klick-Installation über 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. Repository klonen:

   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 von Anmeldedaten (API-Schlüssel, Kennung, Passwort) und Handelssteuerungen 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
CAP_ALLOW_TRADING=true
CAP_ALLOWED_EPICS=ALL

# Optional: enable later for real trading
# CAP_ALLOW_TRADING=true
# Narrow the allowlist to the instruments you actually trade
# 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. Server ausführen:

   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 Konfiguration (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ührungsworkflow (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: true)
• CAP_ALLOWED_EPICS - Instrumente, für die Handel erlaubt ist (Standard: ALL, jedes Instrument). Mit einer kommagetrennten Liste einschränken, z. B. „SILVER,GOLD,BTCUSD". Leer blockiert den gesamten Handel
• 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 dem Login
• 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 Nur-Lese-Ressourcen.

Kategorie	Tools	Beschreibung
Sitzung	4	Login, Logout, 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 scannen
trade_proposal	Einen Trade mit risikobasierter Größenbestimmung planen (nur Vorschau)
execute_trade	Einen zuvor vorgeschauten Trade ausführen
position_review	Offene Positionen und Exposure analysieren (nur lesen)
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)

Für vollständige Details, Parameter und Beispiele siehe USAGE.md.

Handelsausführungsprozess

Verpflichtende zweistufige Ausführung

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

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

   • Gibt preview_id mit normalisierter Anfrage + Risikoprüfungen zurück
   • Keine Seiteneffekte, Nur-Lese-Validierung

2. Ausführung: Trade mit preview_id einreichen

   • 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; der Standard ALL erlaubt jedes Instrument
• Größenlimits: Maximale Positions-/Ordergröße wird durchgesetzt
• Positionslimits: Maximale offene Positionen zu jeder Zeit
• Tageslimits: Maximale Orders pro Tag
• Größennormalisierung: Rundet auf Broker-Minimum/-Maximum/-Schrittweite
• Dry-Run-Modus: Blockiert alle Ausführungen, wenn aktiviert

Dokumentation

• Nutzungsanleitung: USAGE.md - Umfassende Nutzungsanleitung 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 beim Ende der Sitzung verworfen. 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. Jegliche solche Drittanbieter-Software, -Tools oder -Integrationen sind unabhängig von Capital.com und kein Bestandteil der Dienste von Capital.com. Capital.com kontrolliert, entwickelt oder unterstützt keine Drittanbieter-Software, deren Funktionalität, Ausgaben oder Ergebnisse aus deren Nutzung und übernimmt keinerlei Haftung dafür. Die 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 von Ihnen gewählten Drittanbieter-Tools zu prüfen.

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 für Informations- und Handelszwecke 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. API-Verfügbarkeit, -Funktionalität und -Spezifikationen 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.

Ausführungsdienst und keine Anlageberatung

Capital.com erbringt seine Dienste auf reiner Ausführungsbasis. Der Handel mit Finanzinstrumenten ist mit einem erheblichen 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 umfasst auch 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 liegen in Ihrer alleinigen Verantwortung. Capital.com kontrolliert nicht die Ausgaben von Drittanbieter-KI- oder LLM-basierten Tools, die mit der Public API verbunden sind, 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 Prü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 durch falsch konfigurierte Tools oder Parameter entstehen. 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 Leistungen und Ausgaben, die von automatisierten Tools generiert werden, sind kein Indikator für zukünftige Ergebnisse.

Wenn KI- oder LLM-basierte Tools zur Abfrage von Marktdaten oder Preisinformationen verwendet werden, kann es zu einer Verzögerung zwischen dem vom Tool kommunizierten Preis und dem Preis kommen, zu dem ein 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 unserer 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 davon ausgeht, dass ein solcher Missbrauch stattgefunden hat oder wahrscheinlich stattfinden wird. Kunden dürfen Dritten keine Ermessensbefugnis über ihr Konto einräumen.

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, automatisierte Tools oder Integrationen gründlich mit einem Demo-Konto zu testen, bevor Sie sie mit einer Live-Handelsumgebung verbinden.