Capital.com Public API MCP Server

Serveur MCP Capital.com

Serveur Model Context Protocol (MCP) pour l'API publique Capital.com - permettant un accès piloté par LLM à votre compte de trading Capital.com.

⚠️ Avis important

Votre utilisation de l'API publique Capital.com et de tout outil tiers, y compris les outils basés sur l'IA/LLM, se fait à vos propres risques. Capital.com est en mode exécution uniquement et ne cautionne ni n'assume la responsabilité des logiciels tiers ou de leurs résultats. Rien ici ne constitue un conseil en investissement. Vous êtes seul responsable de vos décisions de trading, y compris des écarts de prix résultant de la latence introduite par les outils tiers, et vous devez vous conformer aux conditions et lois applicables.

Les dérivés cryptographiques ne sont pas disponibles pour les clients particuliers enregistrés auprès de Capital Com (UK) Ltd.

• Commencez toujours par un compte démo avant d'envisager le trading en direct
• Le trading est activé par défaut et peut être désactivé dans la configuration
• Toutes les opérations de trading nécessitent une exécution en deux phases (aperçu → confirmation → exécution)
• Contrôles de risque intégrés : listes d'autorisation, limites de taille, plafonds d'ordres quotidiens
• Utilisation à vos propres risques - les auteurs déclinent toute responsabilité en cas de pertes de trading

Pour toute question ou clarification supplémentaire, veuillez vous référer à la FAQ : https://help.capitalccuk.com/hc/en-us/articles/34503231743506-How-to-set-up-the-Capital-com-MCP-Server

Guide de démarrage rapide

Étape 1 : Obtenir les identifiants API Capital.com

1. Créer un compte : Allez sur capital.com/trading/signup

   • Choisissez un compte Démo pour les tests (recommandé)
   • Vérifiez votre e-mail

2. Activer la 2FA : Paramètres > Sécurité > Authentification à deux facteurs

   • Requis avant de générer des clés API

3. Générer une clé API : Paramètres > Intégrations API > Générer une nouvelle clé

   • Définissez un libellé (par exemple, "Serveur MCP")
   • Définissez un mot de passe personnalisé (ce n'est PAS votre mot de passe de plateforme)
   • Enregistrez la clé API affichée (affichée une seule fois !)
   • Remarque : les clés API sont capables de trading ; Capital.com ne propose pas de clés en lecture seule

Étape 2 : Installer et configurer

Installation guidée par IA : Ouvrez ce dossier de projet dans un éditeur alimenté par IA (Claude Code, Cursor, Windsurf) et demandez-lui d'installer le serveur MCP Capital.com — il suivra INSTALL.md pour vous guider tout au long de la configuration, en choisissant la meilleure méthode pour votre environnement.

Vous avez également ces options d'installation manuelle :

Option A : Installation en un clic via le bundle MCPB (recommandé)

Le dépôt inclut un bundle capital-mcp.mcpb pré-construit — ouvrez-le dans Claude Desktop et vous avez terminé, aucune modification manuelle de configuration requise.

Étapes :

1. Clonez le dépôt :

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

2. Ouvrez capital-mcp.mcpb dans Claude Desktop (double-cliquez ou faites-le glisser dans l'application).
3. Claude Desktop vous demandera vos identifiants (clé API, identifiant, mot de passe) et les contrôles de trading. Remplissez-les et cliquez sur Installer.
4. Redémarrez Claude Desktop et vérifiez en demandant : "Quels outils Capital.com sont disponibles ?"

Option B : Installation manuelle via script

Prérequis : Python 3.10+ et Git doivent être installés.

• macOS : brew install python3 git
• Ubuntu/Debian : sudo apt install python3 python3-venv git
• Windows : python.org (cochez "Ajouter au PATH" lors de l'installation) + git-scm.com

Mac/Linux :

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

Windows (PowerShell) :

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

Le script d'installation créera un environnement virtuel, installera les dépendances et imprimera la configuration du client MCP pour vous.

Modifiez .env avec vos identifiants :

# 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

Prérequis : Docker doit être installé.

1. Créez un fichier .env avec vos identifiants (voir .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. Exécutez le serveur :

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

Dépannage : Vérifier les journaux

Si vous rencontrez des problèmes lors de l'utilisation du serveur MCP avec Claude Desktop ou d'autres clients, vérifiez les fichiers journaux :

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

---

Intégration client

Pour une configuration spécifique au client (Claude Desktop, Claude Code, Cursor, Windsurf, Codex, Docker, clients personnalisés), voir USAGE.md — Intégration client.

Exemples d'utilisation

Exemple de conversation avec 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

Flux de travail d'exécution des transactions (lorsque le trading est activé)

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"

Référence des variables d'environnement

Requises

• CAP_ENV - Environnement : demo ou live (défaut : démo)
• CAP_API_KEY - Clé API de Capital.com
• CAP_IDENTIFIER - E-mail de connexion
• CAP_API_PASSWORD - Mot de passe personnalisé de la clé API

Contrôles de risque (recommandés)

• CAP_ALLOW_TRADING - Activer le trading (défaut : true)
• CAP_ALLOWED_EPICS - Instruments sur lesquels le trading est autorisé (défaut : ALL, tous les instruments). Restreignez avec une liste séparée par des virgules, par exemple "SILVER,GOLD,BTCUSD". Vide bloque tout trading
• CAP_MAX_POSITION_SIZE - Taille de position maximale (défaut : 1,0)
• CAP_MAX_WORKING_ORDER_SIZE - Taille d'ordre maximale (défaut : 1,0)
• CAP_MAX_OPEN_POSITIONS - Positions simultanées maximales (défaut : 3)
• CAP_MAX_ORDERS_PER_DAY - Limite d'ordres quotidiens (défaut : 20)
• CAP_REQUIRE_EXPLICIT_CONFIRM - Exiger confirm=true (défaut : true)
• CAP_DRY_RUN - Bloquer toutes les exécutions de transactions (défaut : false)

Facultatives

• CAP_DEFAULT_ACCOUNT_ID - Compte par défaut après connexion
• CAP_HTTP_TIMEOUT_S - Délai d'expiration HTTP (défaut : 15)
• CAP_LOG_LEVEL - Niveau de journalisation : DEBUG, INFO, WARNING, ERROR (défaut : INFO)

Capacités MCP

38 outils dans 6 catégories, 7 invites de flux de travail et 4 ressources en lecture seule.

Catégorie	Outils	Description
Session	4	Connexion, déconnexion, statut, maintien de session
Données de marché	6	Recherche, détails, prix, sentiment, navigation
Compte	6	Liste des comptes, préférences, historique d'activité/transactions, rechargement démo
Trading	13	Aperçu, exécution, clôture de positions ; liste/annulation/modification d'ordres en attente ; confirmations
Listes de surveillance	6	Créer, lister, obtenir, supprimer des listes de surveillance ; ajouter/retirer des marchés
Streaming	3	Prix en temps réel, alertes, P&L de portefeuille via WebSocket

Invite	Description
market_scan	Analyser une liste de surveillance pour des conditions de trading
trade_proposal	Planifier une transaction avec dimensionnement basé sur le risque (aperçu uniquement)
execute_trade	Exécuter une transaction précédemment aperçue
position_review	Analyser les positions ouvertes et l'exposition (lecture seule)
live_price_monitor	Suivi des prix en temps réel avec alertes de mouvement (WebSocket)
real_time_alerts	Alertes de niveaux de prix conditionnels (WebSocket)
live_portfolio_monitor	Tableau de bord P&L de portefeuille en direct (WebSocket)

Ressource	Description
cap://status	Santé du serveur, état de session, limites de débit
cap://risk-policy	Configuration de la gestion des risques et couches de validation
cap://allowed-epics	Configuration de la liste d'autorisation de trading
cap://market-cache/{epic}	Détails du marché en cache (récupération en direct)

Pour tous les détails, paramètres et exemples, voir USAGE.md.

Processus d'exécution des transactions

Exécution obligatoire en deux étapes

Toutes les opérations avec effets secondaires utilisent un flux strict aperçu → exécution :

1. Aperçu : Valider la transaction par rapport aux règles du courtier + politique de risque locale

   • Renvoie preview_id avec la demande normalisée + contrôles de risque
   • Aucun effet secondaire, validation en lecture seule

2. Exécution : Soumettre la transaction en utilisant preview_id

   • Réexécute les contrôles critiques
   • Nécessite confirm=true si CAP_REQUIRE_EXPLICIT_CONFIRM=true
   • Interroge la confirmation du courtier
   • Incrémente le compteur d'ordres quotidiens

Contrôles de risque

• Liste d'autorisation : Seuls les EPIC dans CAP_ALLOWED_EPICS peuvent être négociés ; le ALL par défaut permet tous les instruments
• Limites de taille : Taille maximale de position/ordre appliquée
• Limites de position : Positions ouvertes maximales à tout moment
• Limites quotidiennes : Ordres maximaux par jour
• Normalisation de taille : Arrondit au min/max/incrément du courtier
• Mode simulation : Bloque toutes les exécutions lorsqu'il est activé

Documentation

• Guide d'utilisation : USAGE.md - Guide d'utilisation complet avec exemples
• Référence API Capital.com : https://open-api.capital.com/
• Collection Postman API Capital.com : https://github.com/capital-com-sv/capital-api-postman

Licence

MIT

Politique de confidentialité

Le serveur MCP Capital.com s'exécute localement sur votre machine et communique directement avec l'API publique Capital.com en utilisant les identifiants que vous fournissez. Il ne fonctionne pas comme un service hébergé et ne possède pas ses propres serveurs.

Collecte de données

Le serveur MCP ne collecte ni ne stocke aucune donnée. Il agit comme un pont local entre votre client IA et l'API publique Capital.com.

Utilisation et stockage des données

Toutes les données échangées pendant une session sont traitées en mémoire sur votre machine locale et supprimées à la fin de la session. Aucune donnée n'est écrite sur le disque par le serveur MCP. Remarque : Votre client IA peut traiter, journaliser ou stocker les données qui le traversent conformément à sa propre politique de confidentialité, que vous devez examiner séparément.

Partage avec des tiers

Le serveur MCP ne partage aucune donnée avec des tiers. Les données circulent uniquement entre votre environnement local et l'API publique Capital.com, sous réserve de la politique de confidentialité propre à Capital.com.

Conservation des données

Le serveur MCP ne conserve aucune donnée. Les données de session n'existent qu'en mémoire pendant la durée de la session.

Identifiants API

Les identifiants API que vous fournissez sont stockés et gérés dans votre environnement local. Vous êtes responsable de leur sécurisation appropriée.

Contact

Pour toute question relative à la confidentialité concernant votre compte Capital.com ou la manière dont Capital.com traite vos données, référez-vous à la Politique de confidentialité Capital.com ou contactez support@capital.com.

Avertissement – Utilisation de l'API publique Capital.com avec des outils tiers

Intégration tierce

Cette page décrit comment les clients peuvent connecter l'API publique Capital.com à des logiciels, outils ou intégrations tiers, y compris ceux alimentés par l'intelligence artificielle ou les grands modèles de langage ('LLM'). Tout logiciel, outil ou intégration tiers de ce type est indépendant de Capital.com et ne fait pas partie des services de Capital.com. Capital.com ne contrôle pas, ne développe pas, ne cautionne pas et n'accepte aucune responsabilité pour tout logiciel tiers, sa fonctionnalité, ses sorties ou tout résultat découlant de son utilisation. Toute utilisation d'outils ou d'intégrations tiers en lien avec l'API publique Capital.com se fait entièrement à vos propres risques. Vous êtes responsable de l'examen des conditions, des politiques de confidentialité et des pratiques de traitement des données de tout outil tiers que vous choisissez d'utiliser.

Utilisation de l'API publique

Votre utilisation de l'API publique Capital.com se fait entièrement à votre propre discrétion et à vos propres risques. Capital.com met l'API publique à disposition à des fins d'information et de trading, mais ne recommande, ne cautionne ni n'encourage aucune utilisation, intégration ou stratégie de trading particulière. Vous êtes seul responsable de la manière dont vous accédez à l'API et l'utilisez, y compris les paramètres de toute commande soumise, la configuration de tout outil ou système connecté, et l'interprétation de toute donnée reçue. Capital.com n'accepte aucune responsabilité pour les pertes ou résultats non intentionnels découlant de votre utilisation de l'API, qu'elle soit accessible directement ou via des outils tiers. La disponibilité, la fonctionnalité et les spécifications de l'API peuvent être modifiées, limitées en débit, suspendues ou interrompues à tout moment sans préavis. Votre utilisation de l'API publique est soumise aux conditions générales et aux conditions de trading électronique de Capital.com, que vous devez lire attentivement avant d'utiliser l'API.

Service d'exécution uniquement et absence de conseil en investissement

Capital.com fournit ses services sur une base d'exécution uniquement. La négociation d'instruments financiers comporte un risque de perte important. Rien sur cette page, dans l'API publique, ni dans tout logiciel ou intégration tiers ne constitue un conseil en investissement, une recommandation personnelle ou une sollicitation à acheter ou vendre un instrument financier. Cela inclut toute sortie, signal, suggestion ou analyse générée par des outils d'IA, basés sur des LLM ou d'autres outils automatisés. Toutes les décisions de négociation, y compris toute activité automatisée ou algorithmique, sont prises à vos propres risques et restent votre seule responsabilité. Capital.com ne contrôle pas les sorties des outils d'IA ou basés sur des LLM tiers connectés à l'API publique et ne peut pas garantir que ces outils ne généreront pas de contenu pouvant être interprété comme un conseil en investissement ou une recommandation personnelle. Toute sortie de ce type n'est pas fournie par Capital.com ou en son nom et ne doit pas être considérée comme un conseil.

Risques liés à la négociation automatisée et algorithmique

L'utilisation de l'API publique en lien avec des outils de négociation automatisés ou algorithmiques comporte des risques supplémentaires, notamment : l'exécution rapide d'ordres sans examen ni intervention humaine ; des erreurs système, des défaillances logicielles ou des problèmes de connectivité ; l'exécution à des prix sensiblement différents de ceux attendus ; et des ordres involontaires ou erronés résultant d'outils ou de paramètres mal configurés. Capital.com n'est pas responsable des pertes découlant de ces risques ou de l'interaction entre ses systèmes et tout outil tiers. Les performances passées et toute sortie générée par des outils automatisés ne sont pas indicatives des résultats futurs.

Lorsque des outils d'IA ou basés sur des LLM sont utilisés pour récupérer des données de marché ou des informations de prix, il peut y avoir un délai entre le prix communiqué par l'outil et le prix auquel tout ordre résultant est exécuté. Tous les ordres passés via l'API publique sont exécutés comme des ordres au marché. Le prix d'exécution peut donc différer de tout prix affiché au moment d'une demande. Capital.com s'efforce d'obtenir la meilleure exécution conformément à ses obligations ; nous n'acceptons aucune responsabilité pour les différences de prix découlant de la latence attribuable à des outils ou systèmes tiers hors de son contrôle.

Utilisation interdite

L'utilisation de l'API publique et de tout outil connecté ne doit pas être utilisée pour manipuler la plateforme Capital.com, exploiter les prix ou la latence, se livrer à des abus de marché ou obtenir un avantage déloyal. Capital.com se réserve le droit de restreindre, suspendre ou résilier l'accès à l'API et/ou votre compte lorsqu'elle considère raisonnablement qu'un tel usage abusif s'est produit ou est susceptible de se produire. Les clients ne doivent pas permettre à un tiers d'exercer un contrôle discrétionnaire sur leur compte.

Vos responsabilités

Vous êtes responsable de veiller à ce que votre utilisation de la plateforme Capital.com, de l'API publique et de tout outil ou intégration tiers soit conforme aux conditions générales de Capital.com, aux conditions de négociation électronique et à toutes les lois et réglementations applicables dans votre juridiction. Vous devez examiner attentivement si les outils de négociation automatisés sont appropriés à votre situation, votre expérience et votre tolérance au risque avant de les utiliser. Capital.com recommande fortement de tester minutieusement tout outil ou intégration automatisé à l'aide d'un compte démo avant de les connecter à un environnement de négociation en direct.