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 jeglicher damit verbundener Drittanbieter-Tools, einschließlich KI- oder LLM-basierter Tools, erfolgt nach eigenem Ermessen und auf eigenes Risiko. Capital.com handelt ausschließlich auf Ausführungsbasis und kontrolliert, unterstützt oder übernimmt keine Haftung für Drittanbieter-Software, deren Ergebnisse oder daraus resultierende Folgen. Nichts auf dieser Seite stellt eine Anlageberatung oder Handelsempfehlung dar. Sie sind allein verantwortlich für alle Handelsentscheidungen, Konfigurationen und automatisierten Aktivitäten auf Ihrem Konto und müssen sicherstellen, dass Ihre Nutzung den Allgemeinen Geschäftsbedingungen, den Bedingungen für den elektronischen Handel von Capital.com und allen geltenden Gesetzen in Ihrem Rechtsraum entspricht.

Krypto-Derivate sind für Privatkunden, die bei 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 Handelsoperationen erfordern eine zweiphasige Ausführung (Vorschau → Bestätigen → Ausführen)
• Integrierte Risikokontrollen: Zulassungslisten, Größenlimits, tägliche Orderobergrenzen
• Nutzung auf eigenes Risiko – die Autoren übernehmen keine Haftung für Handelsverluste

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

Kurzanleitung

Schritt 1: Capital.com API-Zugangsdaten 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-Adresse

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

   • Vergeben Sie eine Bezeichnung (z. B. „MCP Server“)
   • Legen Sie ein benutzerdefiniertes 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 schreibgeschützten Schlüssel an

Schritt 2: Installation & Konfiguration

Sie haben zwei Installationsoptionen:

Option A: Ein-Klick-Installation über MCPB-Bundle (Empfohlen)

Das Repository enthält ein manifest.json, das der MCPB (MCP Bundle)-Spezifikation entspricht – dem offenen Standard von Anthropic für die Paketierung lokaler MCP-Server. Damit können Sie den Server in Claude Desktop (und anderen MCPB-kompatiblen Clients) installieren, ohne Konfigurationsdateien manuell bearbeiten zu müssen.

Voraussetzungen: uv (der Server verwendet uv als Laufzeitumgebung – Installation mit brew install uv oder siehe uv-Dokumentation).

Schritte:

1. Repository klonen und das .mcpb-Bundle erstellen (erfordert Node.js für npx):

   git clone https://github.com/capital-com-sv/capital-mcp.git
   cd capital-mcp
   npx @anthropic-ai/mcpb pack . capital-mcp.mcpb
   

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

Siehe MCPB CLI-Referenz für zusätzliche Befehle (validate, info, unpack, sign).

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 (während der Installation „Zu PATH hinzufügen“ 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 Zugangsdaten:

# 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

Schritt 3: Server lokal testen

Mac/Linux:

source venv/bin/activate
python -m capital_mcp.server

Windows (PowerShell):

.\venv\Scripts\Activate.ps1
python -m capital_mcp.server

Sie sollten Folgendes sehen:

INFO - Starting Capital.com MCP Server (env: demo)
INFO - Trading enabled: False

Drücken Sie Strg+C zum Beenden.

Fehlerbehebung: Protokolle prüfen

Wenn bei der Verwendung des MCP-Servers mit Claude Desktop oder anderen Clients Probleme auftreten, überprü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

---

Integration

Hinweis: Ersetzen Sie /path/to/capital-mcp/venv/bin/python durch Ihren tatsächlichen venv-Python-Pfad. Das Installationsskript gibt diesen für Sie aus. Verwenden Sie unter Windows C:\path\to\capital-mcp\venv\Scripts\python.exe.

Claude Desktop

💡 Tipp: Wenn Sie die Installation über das MCPB-Bundle (Option A oben) durchgeführt haben, überspringen Sie diesen Abschnitt – Claude Desktop schreibt die Konfiguration basierend auf manifest.json für Sie. Verwenden Sie diesen Abschnitt nur für manuelle Skriptinstallationen.

macOS/Linux

Konfigurationsspeicherort: ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) oder ~/.config/Claude/claude_desktop_config.json (Linux)

{
  "mcpServers": {
    "capital-com": {
      "command": "/path/to/capital-mcp/venv/bin/python",
      "args": ["-m", "capital_mcp.server"],
      "env": {
        "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",
        "CAP_ALLOWED_EPICS": ""
      }
    }
  }
}

Starten Sie Claude Desktop neu. Überprüfen Sie dies, indem Sie Folgendes eingeben: „Welche Capital.com-Tools sind verfügbar?“

Windows

Konfigurationsspeicherort: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "capital-com": {
      "command": "C:\\path\\to\\capital-mcp\\venv\\Scripts\\python.exe",
      "args": ["-m", "capital_mcp.server"],
      "env": {
        "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",
        "CAP_ALLOWED_EPICS": ""
      }
    }
  }
}

Starten Sie Claude Desktop neu.

Claude Code

claude mcp add capital-com -- /path/to/capital-mcp/venv/bin/python -m capital_mcp.server

Cursor IDE

Öffnen Sie Einstellungen (Cmd+, / Ctrl+,) > Erweiterungen > MCP > Konfigurieren. Fügen Sie hinzu:

{
  "capital-com": {
    "command": "/path/to/capital-mcp/venv/bin/python",
    "args": ["-m", "capital_mcp.server"],
    "env": {
      "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"
    }
  }
}

Starten Sie Cursor neu.

Codex

Einstellungen > MCP-Server > Server hinzufügen. Verwenden Sie denselben Befehl, dieselben Argumente und Umgebungsvariablen wie oben.

Windsurf

Erstellen/Bearbeiten Sie ~/.windsurf/mcp/servers.json:

{
  "mcpServers": {
    "capital-com": {
      "command": "/path/to/capital-mcp/venv/bin/python",
      "args": ["-m", "capital_mcp.server"],
      "env": {
        "CAP_ENV": "demo",
        "CAP_API_KEY": "your_api_key_here",
        "CAP_IDENTIFIER": "your_email@example.com",
        "CAP_API_PASSWORD": "your_custom_password"
      }
    }
  }
}

Starten Sie Windsurf neu.

Benutzerdefinierte MCP-Clients

Jeder STDIO-fähige MCP-Client funktioniert. Beispiel mit Node.js:

import { spawn } from 'child_process';

const server = spawn('/path/to/venv/bin/python', ['-m', 'capital_mcp.server'], {
  env: {
    ...process.env,
    CAP_ENV: 'demo',
    CAP_API_KEY: 'your_key',
    CAP_IDENTIFIER: 'your_email',
    CAP_API_PASSWORD: 'your_password',
    CAP_ALLOW_TRADING: 'false'
  }
});

// Communicate via STDIO (JSON-RPC)
// Read from server.stdout, write to server.stdin

Anwendungsbeispiele

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 ist)

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 - Benutzerdefiniertes Passwort für den API-Schlüssel

Risikokontrollen (Empfohlen)

• CAP_ALLOW_TRADING - Handel aktivieren (Standard: false)
• CAP_ALLOWED_EPICS - Durch Kommas getrennte Zulassungsliste (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 - Bestätigung=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 - Protokollstufe: DEBUG, INFO, WARNING, ERROR (Standard: INFO)

MCP-Tools (36 implementiert)

Sitzung (4)

• cap_session_status - Sitzungsinformationen abrufen
• cap_session_login - Sitzung erstellen
• cap_session_ping - Sitzung aufrechterhalten
• cap_session_logout - Sitzung beenden

Marktdaten (6)

• cap_market_search - Märkte durchsuchen
• cap_market_get - Marktdetails abrufen
• cap_market_prices - Historische Kurse
• cap_market_sentiment - Kundenstimmung
• cap_market_navigation_root - Marktkategorien-Stamm
• cap_market_navigation_node - Marktkategorien-Knoten

Konto (6)

• cap_account_list - Konten auflisten
• cap_account_preferences_get - Einstellungen abrufen
• cap_account_preferences_set - Einstellungen festlegen
• cap_account_history_activity - Aktivitätsverlauf
• cap_account_history_transactions - Transaktionsverlauf
• cap_account_demo_topup - Demo-Konto aufladen

Handel (11)

• Schreibgeschützt:

  • cap_trade_positions_list - Positionen auflisten
  • cap_trade_positions_get - Positionsdetails abrufen
  • cap_trade_orders_list - Arbeitsaufträge auflisten
  • cap_trade_confirm_get - Bestätigungsstatus abrufen
  • cap_trade_confirm_wait - Auf Bestätigung warten

• Vorschau:

  • cap_trade_preview_position - Positionsvorschau
  • cap_trade_preview_working_order - Ordervorschau

• Ausführen:

  • cap_trade_execute_position - Position ausführen
  • cap_trade_execute_working_order - Order ausführen
  • cap_trade_positions_close - Position schließen
  • cap_trade_orders_cancel - Order abbrechen

Beobachtungslisten (6)

• cap_watchlists_list - Beobachtungslisten auflisten
• cap_watchlists_create - Beobachtungsliste erstellen
• cap_watchlists_get - Beobachtungsliste abrufen
• cap_watchlists_add_market - Markt hinzufügen
• cap_watchlists_delete - Beobachtungsliste löschen
• cap_watchlists_remove_market - Markt entfernen

Streaming (3)

• cap_stream_prices - Echtzeitkurse streamen (WebSocket)
• cap_stream_alerts - Kurslevel-Alarme streamen (WebSocket)
• cap_stream_portfolio - Live-Portfolio-Gewinn/Verlust streamen (WebSocket)

MCP-Prompts (Workflow-Vorlagen)

MCP-Prompts sind strukturierte Workflows, die Claude durch komplexe, mehrstufige Handelsoperationen führen. Sie bieten Schritt-für-Schritt-Anleitungen und Best Practices für häufige Aufgaben.

Verfügbare Prompts (7)

1. market_scan - Marktanalyse-Workflow

Führt Sie durch das Scannen einer Beobachtungsliste auf Handelsbedingungen.

Parameter:

• watchlist_id - Zu scannende Beobachtungsliste (leer lassen, um zuerst Beobachtungslisten aufzulisten)
• timeframe - Kursauflösung: MINUTE, MINUTE_5, HOUR, DAY (Standard: HOUR)
• lookback_periods - Anzahl der abzurufenden Kerzen: 1-1000 (Standard: 24)

Workflow:

1. Märkte der Beobachtungsliste abrufen
2. Kursdaten für jeden Markt abrufen
3. Technische Analyse (Trends, Unterstützung/Widerstand, Muster)
4. Optionale Stimmungsprüfung
5. Zusammenfassung der Gelegenheiten erstellen

Anwendungsbeispiel:

• „Verwende den market_scan-Prompt, um meine Beobachtungsliste zu analysieren“
• „Scanne meine Märkte nach Handels-Setups“

Echter Handel: Ändern Sie Ihre Konfigurationen auf: CAP_ENV: 'live', CAP_ALLOW_TRADING: 'true'

2. trade_proposal - Handelsplanungs-Workflow

Führt Sie durch die Erstellung eines Handelsvorschlags mit Risikomanagement-Tools.

Parameter:

• epic - Zu handelnder Markt (erforderlich, z. B. SILVER, GOLD)
• direction - BUY oder SELL (Standard: BUY)
• thesis - Ihre Handelsbegründung (optional)
• risk_percent - Risiko als % des Guthabens (Standard: 1,0 %)

Workflow:

1. Marktdetails und Handelsregeln abrufen
2. Positionsgröße basierend auf Risiko-% berechnen
3. Stop-Loss- und Take-Profit-Level definieren
4. Vorschau des Handels (nur Validierung – keine Ausführung)
5. Vorschau-ID für mögliche Ausführung zurückgeben

Anwendungsbeispiel:

• „Erstelle einen Handelsvorschlag für SILVER“
• „Schlage einen Long-Trade auf GOLD mit 2 % Risiko vor“

Hinweis: Dieser Prompt führt KEINE Trades aus – er erstellt nur Vorschauen.

3. execute_trade - Handelsausführungs-Workflow

Führt Sie durch die Ausführung eines in der Vorschau angezeigten Handels.

Parameter:

• preview_id - Vorschau-ID aus trade_proposal (erforderlich)

Workflow:

1. Überprüfen, ob die Vorschau-ID bereitgestellt und gültig ist
2. Alle Risikokontrollen erneut prüfen
3. Position beim Broker ausführen
4. Auf Bestätigung warten (AKZEPTIERT/ABGELEHNT)
5. Endgültigen Status melden

Anwendungsbeispiel:

• „Führe den Trade aus, den ich gerade in der Vorschau gesehen habe“
• „Platziere den Trade mit der Vorschau-ID abc-123“

Hinweis:

• Erfordert CAP_ALLOW_TRADING=true
• Erfordert Epic in der Zulassungsliste
• Vorschau darf nicht abgelaufen sein (2-Minuten-TTL)
• ⚠️ Dies WIRD einen echten Trade platzieren

4. position_review - Portfolioanalyse-Workflow

Führt Sie durch die Analyse Ihrer offenen Positionen und Orders.

Parameter: Keine (analysiert alle aktuellen Positionen)

Workflow:

1. Alle offenen Positionen abrufen
2. Alle Arbeitsaufträge abrufen
3. Gewinn/Verlust, Risiko- und Expositionskennzahlen berechnen
4. Konzentrations- und Korrelationsrisiken identifizieren
5. Mögliche Anpassungen vorschlagen (ohne Ausführung)

Anwendungsbeispiel:

• „Überprüfe meine aktuellen Positionen“
• „Analysiere meine Portfolio-Exposition“

Hinweis: Dies ist ein schreibgeschützter Workflow – es werden keine Trades ausgeführt.

5. live_price_monitor - Echtzeit-Kursverfolgung (WebSocket)

Überwachen Sie Live-Marktpreise mit sofortigen Alarmen, wenn sich Kurse über einen Schwellenwert hinaus bewegen.

Parameter:

• epics - Liste der zu überwachenden Markt-EPICs (leer lassen zum Suchen/Auswählen, max. 40)
• duration_minutes - Überwachungsdauer (Standard: 5 Minuten, max.: 10 Minuten)
• threshold_percent - Alarm bei Kursbewegung > dieser % (Standard: 1,0 %)

Workflow:

1. Zu überwachende Märkte auswählen (oder EPICs direkt angeben)
2. Anfangskurse abrufen, um eine Basislinie festzulegen
3. Echtzeit-WebSocket-Kursaktualisierungen abonnieren
4. Live-Kurstafel mit kontinuierlichen Aktualisierungen anzeigen
5. Alarm auslösen, wenn sich ein Markt um mehr als threshold_percent bewegt
6. Automatisches Stoppen nach duration_minutes

Anwendungsbeispiel:

• „Überwache GOLD- und SILVER-Preise für 2 Minuten“
• „Beobachte BTC für die nächsten 5 Minuten, alarmiere bei 2 % Bewegung“

Hinweis: Erfordert CAP_WS_ENABLED=true. Capital.com WebSocket-Sitzungen dauern maximal 10 Minuten.

6. real_time_alerts - Bedingte Preisalarme (WebSocket)

Legen Sie Preisniveau-Alarme fest und erhalten Sie sofortige Benachrichtigungen, wenn Märkte Ihre Ziele erreichen.

Parameter:

• alert_config - Alarmniveaus pro EPIC (z. B. {"GOLD": 2050.0, "SILVER": 28.5})
• duration_minutes - Maximale Überwachungsdauer (Standard: 5 Minuten)
• auto_stop - Überwachung nach erstem Alarm beenden? (Standard: true)

Arbeitsablauf:

1. Alarmbedingungen konfigurieren (Preisniveaus für jeden Markt)
2. WebSocket-Preisaktualisierungen abonnieren
3. Kontinuierlich auf Alarmauslöser überwachen
4. Sofortigen Alarm ausgeben, wenn Bedingung erfüllt ist
5. Optional Überwachung fortsetzen oder nach erstem Alarm beenden

Beispielverwendung:

• „Alarmiere mich, wenn GOLD 2050 erreicht“
• „Benachrichtige, wenn SILVER unter 28 fällt“

Hinweis: Erfordert CAP_WS_ENABLED=true.

7. live_portfolio_monitor - Echtzeit-Gewinn- und Verlustverfolgung (WebSocket)

Verfolgen Sie die Aktualisierung Ihres Portfolio-Gewinns und -Verlusts in Echtzeit, während sich die Marktpreise bewegen.

Parameter:

• duration_minutes - Überwachungsdauer (Standard: 5 Minuten, max.: 10 Minuten)
• alert_pnl_threshold - Alarm, wenn der Gesamt-Gewinn/Verlust diesen Betrag überschreitet (Standard: 100 $)

Arbeitsablauf:

1. Aktuelle offene Positionen abrufen
2. Preisaktualisierungen für Positionsmärkte abonnieren
3. Live-Gewinn/Verlust bei Preisänderungen berechnen
4. Echtzeit-Portfolio-Dashboard anzeigen
5. Alarm, wenn Gewinn/Verlust den Schwellenwert überschreitet

Beispielverwendung:

• „Überwache meinen Portfolio-Gewinn/Verlust für 5 Minuten“
• „Beobachte Positionen in Echtzeit, Alarm bei 500 $ Gewinn/Verlust“

Hinweis: Erfordert CAP_WS_ENABLED=true und aktive Positionen.

Verwendung von Prompts

In Claude Desktop oder anderen MCP-Clients erscheinen Prompts als verfügbare Interaktionsmuster. Sie können sie auf natürliche Weise im Gespräch aufrufen:

User: "I want to scan my watchlist for opportunities"
Claude: [Invokes market_scan prompt, guides through the workflow]

User: "Create a trade plan for SILVER"
Claude: [Invokes trade_proposal prompt, designs trade with risk management]

User: "Execute that trade"
Claude: [Invokes execute_trade prompt, submits to broker]

User: "Show me my open positions"
Claude: [Invokes position_review prompt, analyzes portfolio]

Prompts bieten strukturierte Anleitung, während die Handelskontrollen während des gesamten Arbeitsablaufs beibehalten werden.

MCP-Ressourcen (schreibgeschützte Daten)

MCP-Ressourcen bieten schreibgeschützten Zugriff auf Serverstatus und -konfiguration über URI-basierte Ressourcen. Im Gegensatz zu Tools (die Aktionen ausführen) stellen Ressourcen Daten bereit, die Clients lesen und überwachen können.

Verfügbare Ressourcen

1. cap://status - Serverstatus

Echtzeit-Server- und Sitzungsinformationen.

Rückgabe: JSON mit Serverzustand, Sitzungsstatus, Authentifizierungsstatus, Ratenlimits

Beispiel:

{
  "server": {
    "name": "Capital.com MCP Server",
    "version": "0.1.0",
    "trading_enabled": true
  },
  "session": {
    "logged_in": true,
    "account_id": "ABC123",
    "last_used_at": "2026-01-16T10:30:00Z",
    "expires_in_s_estimate": 522
  },
  "risk": {
    "trading_enabled": true,
    "allowed_epics": ["GOLD", "SILVER"],
    "allowlist_mode": "SPECIFIC"
  },
  "rate_limits": {
    "requests_per_second": "10",
    "note": "Capital.com enforces 10 req/s limit"
  }
}

Anwendungsfälle: Serverzustand überwachen, Sitzungsstatus prüfen, Authentifizierungsprobleme debuggen

---

2. cap://risk-policy - Risikorichtlinie

Umfassende Risikomanagement-Konfiguration und Handelskontrollen.

Rückgabe: JSON mit allen Validierungsebenen, Handelskontrollfunktionen und Handelsbeschränkungen

Beispiel:

{
  "trading_enabled": true,
  "two_phase_execution": true,
  "description": "All trades require preview → explicit execution",
  "allowlist": {
    "mode": "SPECIFIC",
    "epics": ["GOLD", "SILVER"],
    "note": "Only markets on this list can be traded (ALL = wildcard)"
  },
  "validation_layers": [
    "1. Trading enabled check (TRADING_ENABLED env var)",
    "2. Epic allowlist check (must be in ALLOWED_EPICS)",
    "... 10 total layers ..."
  ],
  "execution_controls": {
    "preview_required": true,
    "deal_reference_matching": true,
    "authentication_required": true,
    "rate_limiting": true,
    "input_validation": true
  }
}

Anwendungsfälle: Aktive Handelskontrollen verstehen, Risikokonfiguration prüfen, Compliance-Dokumentation

---

3. cap://allowed-epics - Handels-Zulassungsliste

Aktuelle Konfiguration der Handels-Zulassungsliste mit den erlaubten Märkten.

Rückgabe: JSON mit Zulassungslistenmodus, erlaubten Epics und Konfigurationsanweisungen

Beispiel:

{
  "mode": "SPECIFIC",
  "allowed_epics": ["GOLD", "SILVER", "BTCUSD"],
  "count": 3,
  "trading_enabled": true,
  "description": "Restricted mode: 3 specific markets allowed",
  "configuration": {
    "env_var": "ALLOWED_EPICS",
    "example": "ALLOWED_EPICS=GOLD,SILVER,BTCUSD",
    "wildcard": "ALLOWED_EPICS=ALL (allows all markets)"
  }
}

Anwendungsfälle: Prüfen, welche Märkte handelbar sind, Zulassungslistenkonfiguration verifizieren

---

4. cap://market-cache/{epic} - Marktdetails (dynamisch)

Zwischengespeicherte Marktdetails für einen bestimmten Epic (Live-Abruf vom Broker).

Parameter:

• epic - Marktkennung (z. B. „GOLD“, „SILVER“, „CS.D.EURUSD.TODAY.IP“)

Rückgabe: JSON mit umfassenden Marktinformationen

Authentifizierung: Erforderlich

Beispiel: cap://market-cache/GOLD

{
  "epic": "GOLD",
  "instrument_name": "Spot Gold",
  "instrument_type": "COMMODITIES",
  "currency": "USD",
  "snapshot": {
    "market_status": "TRADEABLE",
    "bid": 2050.50,
    "offer": 2050.75,
    "update_time": "2026-01-16T10:30:00"
  },
  "dealing": {
    "min_size": 0.1,
    "max_size": 100.0,
    "min_step": 0.1,
    "min_stop_distance": 5.0
  },
  "margin": {
    "factor": 5.0,
    "unit": "PERCENTAGE"
  },
  "opening_hours": {...},
  "cached_at": "2026-01-16T10:30:00"
}

Anwendungsfälle: Marktdetails abrufen, Handelsregeln prüfen, Margin-Anforderungen analysieren

---

Verwendung von Ressourcen

In Claude Desktop oder anderen MCP-Clients kann auf Ressourcen per URI zugegriffen werden:

User: "Show me the server status"
Claude: [Reads cap://status resource, displays server health]

User: "What's the risk policy?"
Claude: [Reads cap://risk-policy resource, explains trading controls]

User: "Which markets can I trade?"
Claude: [Reads cap://allowed-epics resource, lists permitted epics]

User: "Show all my watchlists"
Claude: [Calls cap_watchlists_list tool, displays watchlist data]

User: "Get details for GOLD market"
Claude: [Reads cap://market-cache/GOLD resource, shows market info]

Ressourcen bieten eine bequeme Möglichkeit, Serverstatus und -konfiguration zu überprüfen, ohne Tools auszuführen. Für Watchlist-Daten verwenden Sie die Tools cap_watchlists_list und cap_watchlists_get.

Handelsausführungsprozess

Obligatorischer zweistufiger Ablauf

Alle Operationen mit Seiteneffekten verwenden einen strikten Vorschau → Ausführen-Ablauf:

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

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

2. Ausführen: Handel 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

• Zulassungsliste: Nur EPICs in CAP_ALLOWED_EPICS können gehandelt werden
• Größenlimits: Maximale Positions-/Ordergröße wird erzwungen
• Positionslimits: Maximale offene Positionen zu jeder Zeit
• Tageslimits: Maximale Orders pro Tag
• Größennormalisierung: Rundet auf Broker-Min/Max/Inkrement
• Dry-Run-Modus: Blockiert alle Ausführungen, wenn aktiviert

Dokumentation

• Nutzungshandbuch: USAGE.md - Umfassendes Nutzungshandbuch mit Beispielen
• Capital.com API-Referenz: https://open-api.capital.com/
• Capital.com API Postman Collection: https://github.com/capital-com-sv/capital-api-postman

Lizenz

MIT

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

Drittanbieter-Integration

Diese Seite beschreibt, wie Kunden 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 nicht Teil der Dienstleistungen von Capital.com. Capital.com kontrolliert, entwickelt, unterstützt oder übernimmt keine Haftung für Drittanbieter-Software, deren Funktionalität, Ergebnisse oder jegliche aus ihrer Nutzung resultierenden Folgen. Die Nutzung von Drittanbieter-Tools oder -Integrationen in Verbindung mit der Capital.com Public API erfolgt ausschließlich auf Ihr eigenes Risiko. Sie sind verantwortlich für die Prüfung der Bedingungen, Datenschutzrichtlinien und Datenverarbeitungspraktiken jedes von Ihnen genutzten Drittanbieter-Tools.

Nutzung der Public API

Ihre Nutzung der Capital.com Public API erfolgt ausschließlich nach Ihrem eigenen Ermessen und auf Ihr eigenes Risiko. Capital.com stellt die Public API zu Informations- und Handelszwecken zur Verfügung, empfiehlt, unterstützt oder fördert jedoch keine bestimmte Nutzung, Integration oder Handelsstrategie. Sie sind allein verantwortlich dafür, wie Sie auf die API zugreifen und sie nutzen, einschließlich der Parameter eingereichter Orders, der Konfiguration verbundener Tools oder Systeme und der Interpretation empfangener Daten. Capital.com übernimmt keine Haftung für Verluste oder unbeabsichtigte Ergebnisse, die aus Ihrer Nutzung der API entstehen, sei es durch direkten Zugriff 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 Elektronischen Handelsbedingungen von Capital.com, die Sie vor der Nutzung der API sorgfältig lesen sollten.

Reiner Ausführungsdienst und keine Anlageberatung Capital.com erbringt seine Dienstleistungen auf reiner Ausführungsbasis. Der Handel mit Finanzinstrumenten birgt ein erhebliches Verlustrisiko. 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 schließt jegliche Ergebnisse, Signale, Vorschläge oder Analysen ein, die von KI, LLM-basierten oder anderen automatisierten Tools generiert werden. Alle Handelsentscheidungen, einschließlich jeglicher automatisierter oder algorithmischer Aktivitäten, erfolgen auf Ihr eigenes Risiko und bleiben in Ihrer alleinigen Verantwortung. 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 Orders ohne menschliche Überprüfung oder Eingriff; Systemfehler, Softwareausfälle oder Verbindungsprobleme; Ausführung zu Preisen, die wesentlich von den erwarteten abweichen; und unbeabsichtigte oder fehlerhafte Orders aufgrund falsch konfigurierter Tools oder Parameter. Capital.com ist nicht verantwortlich für Verluste, die aus solchen Risiken oder aus der Interaktion zwischen seinen Systemen und Drittanbieter-Tools entstehen. Die Wertentwicklung in der Vergangenheit und jegliche von automatisierten Tools generierten Ergebnisse sind kein Indikator für zukünftige Ergebnisse.

Verbotene Nutzung

Die Nutzung der Public API und aller verbundenen Tools darf nicht dazu dienen, die Capital.com-Plattform zu manipulieren, Preisgestaltung oder Latenz auszunutzen, Marktmissbrauch zu betreiben oder sich einen unfairen Vorteil zu verschaffen. Capital.com behält sich das Recht vor, den API-Zugang und/oder Ihr Konto einzuschränken, auszusetzen oder zu kündigen, wenn es nach vernünftigem Ermessen der Ansicht ist, dass ein solcher Missbrauch stattgefunden hat oder wahrscheinlich stattfinden wird. Kunden dürfen keinem Dritten erlauben, diskretionäre Kontrolle über ihr Konto auszuüben.

Ihre Verantwortlichkeiten

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