Capital.com Public API MCP Server

Serveur MCP Capital.com

Serveur Model Context Protocol (MCP) pour l'API ouverte 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 un service d'exécution uniquement et n'approuve 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 devez vous conformer aux conditions et lois applicables.

Les dérivés de crypto-monnaies ne sont pas disponibles pour les clients de détail 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 désactivé par défaut et nécessite une configuration explicite
• 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 blanches, 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 consulter 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 les 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, « MCP Server »)
   • 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 trader ; Capital.com ne propose pas de clés en lecture seule

Étape 2 : Installation et configuration

Installation assistée par IA : Ouvrez ce dossier de projet dans un éditeur propulsé par l'IA (Claude Code, Cursor, Windsurf) et demandez-lui d'installer le serveur MCP Capital.com — il suivra INSTALL.md pour vous guider dans 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 c'est 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 glissez-le 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 « Add to 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 affichera la configuration 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 (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

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 la 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 : false)
• CAP_ALLOWED_EPICS - Liste blanche séparée par des virgules (par exemple, « SILVER,GOLD,BTCUSD ») ou « ALL » pour un accès illimité
• 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 - Nombre maximal de positions simultanées (défaut : 3)
• CAP_MAX_ORDERS_PER_DAY - Limite d'ordres quotidienne (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)

Optionnelles

• 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 répartis dans 6 catégories, 7 prompts 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	Lister les comptes, préférences, historique d'activité/transactions, rechargement démo
Trading	13	Aperçu, exécution, clôture de positions ; lister/annuler/modifier les 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

Prompt	Description
market_scan	Analyser une liste de surveillance pour détecter 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 prévisualisée
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 blanche 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 quotidien

Contrôles de risque

• Liste blanche : Seuls les EPIC dans CAP_ALLOWED_EPICS peuvent être négociés
• Limites de taille : Taille maximale de position/ordre appliquée
• Limites de positions : Nombre maximal de positions ouvertes à tout moment
• Limites quotidiennes : Nombre maximal d'ordres par jour
• Normalisation de la 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 devriez 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 de 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, consultez la Politique de confidentialité de 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 propulsés par l'intelligence artificielle ou les grands modèles de langage (« LLM »). Tout logiciel, outil ou intégration tiers 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, n'approuve pas et n'accepte aucune responsabilité pour tout logiciel tiers, ses fonctionnalités, 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, n'approuve 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 imprévus découlant de votre utilisation de l'API, qu'elle soit accessible directement ou via des outils tiers. La disponibilité, les fonctionnalités 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 devriez 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. Le trading d'instruments financiers comporte un risque important de perte. Rien sur cette page, dans l'API publique ou 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 l'IA, les outils basés sur les LLM ou d'autres outils automatisés. Toutes les décisions de trading, 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 tiers basés sur l'IA ou les LLM connectés à l'API publique et ne peut pas garantir que ces outils ne généreront pas de contenu qui pourrait être interprété comme un conseil en investissement ou une recommandation personnelle. Toute sortie de ce type n'est pas fournie par ou au nom de Capital.com et ne doit pas être considérée comme un conseil.

Risques liés au trading automatisé et algorithmique

L'utilisation de l'API publique en relation avec des outils de trading automatisé ou algorithmique 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 tout résultat généré par des outils automatisés ne préjugent pas des résultats futurs.

Lorsque des outils basés sur l'IA ou les 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 ordres au marché. Le prix d'exécution peut donc différer de tout prix affiché au moment de la 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 estime raisonnablement que cet abus a eu lieu 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 trading électronique et à toutes les lois et réglementations applicables dans votre juridiction. Vous devez examiner attentivement si les outils de trading automatisé 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 trading en direct.