Capital.com Public API MCP Server

Servidor MCP de Capital.com

Servidor de Model Context Protocol (MCP) para la API abierta de Capital.com, que permite el acceso impulsado por LLM a tu cuenta de trading de Capital.com.

⚠️ Aviso importante

El uso de la API pública de Capital.com y de cualquier herramienta de terceros, incluidas las basadas en IA/LLM, es bajo tu propio riesgo. Capital.com es de solo ejecución y no respalda ni se hace responsable de software de terceros ni de sus resultados. Nada de lo aquí expuesto constituye asesoramiento de inversión. Eres el único responsable de tus decisiones de trading, incluida cualquier diferencia de precios derivada de la latencia introducida por herramientas de terceros, y debes cumplir con los términos y leyes aplicables.

Los derivados de criptomonedas no están disponibles para clientes minoristas registrados en Capital Com (UK) Ltd.

• Comienza siempre con una cuenta Demo antes de considerar el trading en vivo.
• El trading está habilitado por defecto y puede desactivarse en la configuración.
• Todas las operaciones requieren ejecución en dos fases (vista previa → confirmación → ejecución).
• Controles de riesgo integrados: listas de permitidos, límites de tamaño, topes diarios de órdenes.
• Úsalo bajo tu propio riesgo: los autores no asumen responsabilidad por pérdidas de trading.

Para más preguntas/aclaraciones, consulta las FAQ: https://help.capitalccuk.com/hc/en-us/articles/34503231743506-How-to-set-up-the-Capital-com-MCP-Server

Guía de inicio rápido

Paso 1: Obtén las credenciales de la API de Capital.com

1. Crea una cuenta: Ve a capital.com/trading/signup

   • Elige una cuenta Demo para probar (recomendado).
   • Verifica tu correo electrónico.

2. Habilita la 2FA: Configuración > Seguridad > Autenticación de dos factores.

   • Requerido antes de generar claves de API.

3. Genera una clave de API: Configuración > Integraciones de API > Generar nueva clave.

   • Establece una etiqueta (por ejemplo, "MCP Server").
   • Establece una contraseña personalizada (esta NO es la contraseña de tu plataforma).
   • Guarda la clave de API mostrada (¡se muestra solo una vez!).
   • Nota: Las claves de API tienen capacidad de trading; Capital.com no ofrece claves de solo lectura.

Paso 2: Instala y configura

Instalación guiada por IA: Abre esta carpeta de proyecto en un editor con IA (Claude Code, Cursor, Windsurf) y pídele que instale el servidor MCP de Capital.com; seguirá INSTALL.md para guiarte en la configuración, eligiendo el mejor método para tu entorno.

También tienes estas opciones de instalación manual:

Opción A: Instalación con un clic mediante el paquete MCPB (recomendado)

El repositorio incluye un paquete capital-mcp.mcpb precompilado: ábrelo en Claude Desktop y listo, sin necesidad de editar la configuración manualmente.

Pasos:

1. Clona el repositorio:

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

2. Abre capital-mcp.mcpb en Claude Desktop (doble clic o arrástralo a la aplicación).
3. Claude Desktop te pedirá las credenciales (clave de API, identificador, contraseña) y los controles de trading. Complétalos y haz clic en Instalar.
4. Reinicia Claude Desktop y verifica preguntando: "¿Qué herramientas de Capital.com están disponibles?"

Opción B: Instalación manual mediante script

Requisitos previos: Python 3.10+ y Git deben estar instalados.

• macOS: brew install python3 git
• Ubuntu/Debian: sudo apt install python3 python3-venv git
• Windows: python.org (marca "Add to PATH" durante la instalación) + git-scm.com

Mac/Linux:

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

Windows (PowerShell):

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

El script de instalación creará un entorno virtual, instalará las dependencias e imprimirá la configuración del cliente MCP.

Edita .env con tus credenciales:

# 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

Opción C: Docker

Requisitos previos: Docker debe estar instalado.

1. Crea un archivo .env con tus credenciales (consulta .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. Ejecuta el servidor:

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

Solución de problemas: consulta los registros

Si encuentras problemas al usar el servidor MCP con Claude Desktop u otros clientes, consulta los archivos de registro:

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

---

Integración con clientes

Para la configuración específica de cada cliente (Claude Desktop, Claude Code, Cursor, Windsurf, Codex, Docker, clientes personalizados), consulta USAGE.md — Integración con clientes.

Ejemplos de uso

Ejemplo de conversación con 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

Flujo de ejecución de operaciones (cuando el trading está habilitado)

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"

Referencia de variables de entorno

Requeridas

• CAP_ENV - Entorno: demo o live (predeterminado: demo)
• CAP_API_KEY - Clave de API de Capital.com
• CAP_IDENTIFIER - Correo electrónico de inicio de sesión
• CAP_API_PASSWORD - Contraseña personalizada de la clave de API

Controles de riesgo (recomendados)

• CAP_ALLOW_TRADING - Habilitar trading (predeterminado: true)
• CAP_ALLOWED_EPICS - Instrumentos en los que se permite operar (predeterminado: ALL, todos los instrumentos). Restringe con una lista separada por comas, por ejemplo, "SILVER,GOLD,BTCUSD". Vacío bloquea todo el trading.
• CAP_MAX_POSITION_SIZE - Tamaño máximo de posición (predeterminado: 1.0)
• CAP_MAX_WORKING_ORDER_SIZE - Tamaño máximo de orden (predeterminado: 1.0)
• CAP_MAX_OPEN_POSITIONS - Máximo de posiciones concurrentes (predeterminado: 3)
• CAP_MAX_ORDERS_PER_DAY - Límite diario de órdenes (predeterminado: 20)
• CAP_REQUIRE_EXPLICIT_CONFIRM - Requerir confirm=true (predeterminado: true)
• CAP_DRY_RUN - Bloquear todas las ejecuciones de trading (predeterminado: false)

Opcionales

• CAP_DEFAULT_ACCOUNT_ID - Cuenta predeterminada después del inicio de sesión
• CAP_HTTP_TIMEOUT_S - Tiempo de espera HTTP (predeterminado: 15)
• CAP_LOG_LEVEL - Nivel de registro: DEBUG, INFO, WARNING, ERROR (predeterminado: INFO)

Capacidades de MCP

38 herramientas en 6 categorías, 7 flujos de trabajo de prompts y 4 recursos de solo lectura.

Categoría	Herramientas	Descripción
Sesión	4	Inicio de sesión, cierre de sesión, estado, keep-alive
Datos de mercado	6	Búsqueda, detalles, precios, sentimiento, navegación
Cuenta	6	Listar cuentas, preferencias, historial de actividad/transacciones, recarga de demo
Trading	13	Vista previa, ejecución, cierre de posiciones; listar/cancelar/modificar órdenes pendientes; confirmaciones
Listas de seguimiento	6	Crear, listar, obtener, eliminar listas de seguimiento; añadir/eliminar mercados
Streaming	3	Precios en tiempo real, alertas, P&L de cartera vía WebSocket

Prompt	Descripción
market_scan	Escanear una lista de seguimiento para condiciones de trading
trade_proposal	Planificar una operación con dimensionamiento basado en riesgo (solo vista previa)
execute_trade	Ejecutar una operación previamente vista en vista previa
position_review	Analizar posiciones abiertas y exposición (solo lectura)
live_price_monitor	Seguimiento de precios en tiempo real con alertas de movimiento (WebSocket)
real_time_alerts	Alertas condicionales de niveles de precios (WebSocket)
live_portfolio_monitor	Panel de P&L de cartera en vivo (WebSocket)

Recurso	Descripción
cap://status	Salud del servidor, estado de sesión, límites de tasa
cap://risk-policy	Configuración de gestión de riesgos y capas de validación
cap://allowed-epics	Configuración de la lista de permitidos de trading
cap://market-cache/{epic}	Detalles de mercado en caché (obtención en vivo)

Para detalles completos, parámetros y ejemplos, consulta USAGE.md.

Proceso de ejecución de operaciones

Ejecución obligatoria en dos pasos

Todas las operaciones con efectos secundarios utilizan un flujo estricto de vista previa → ejecución:

1. Vista previa: Valida la operación contra las reglas del bróker + la política de riesgo local.

   • Devuelve preview_id con la solicitud normalizada + comprobaciones de riesgo.
   • Sin efectos secundarios, validación de solo lectura.

2. Ejecución: Envía la operación usando preview_id.

   • Vuelve a ejecutar comprobaciones críticas.
   • Requiere confirm=true si CAP_REQUIRE_EXPLICIT_CONFIRM=true.
   • Consulta la confirmación del bróker.
   • Incrementa el contador diario de órdenes.

Controles de riesgo

• Lista de permitidos: Solo se pueden operar los EPIC en CAP_ALLOWED_EPICS; el ALL predeterminado permite todos los instrumentos.
• Límites de tamaño: Se aplica el tamaño máximo de posición/orden.
• Límites de posición: Máximo de posiciones abiertas en cualquier momento.
• Límites diarios: Máximo de órdenes por día.
• Normalización de tamaño: Redondea al mínimo/máximo/incremento del bróker.
• Modo de prueba: Bloquea todas las ejecuciones cuando está habilitado.

Documentación

• Guía de uso: USAGE.md - Guía de uso completa con ejemplos.
• Referencia de la API de Capital.com: https://open-api.capital.com/
• Colección Postman de la API de Capital.com: https://github.com/capital-com-sv/capital-api-postman

Licencia

MIT

Política de privacidad

El servidor MCP de Capital.com se ejecuta localmente en tu máquina y se comunica directamente con la API pública de Capital.com utilizando las credenciales que proporcionas. No opera como un servicio alojado y no tiene servidores propios.

Recopilación de datos

El servidor MCP no recopila ni almacena ningún dato. Actúa como un puente local entre tu cliente de IA y la API pública de Capital.com.

Uso y almacenamiento de datos

Todos los datos intercambiados durante una sesión se procesan en memoria en tu máquina local y se descartan cuando la sesión termina. El servidor MCP no escribe ningún dato en disco. Nota: Tu cliente de IA puede procesar, registrar o almacenar datos que pasen a través de él de acuerdo con su propia política de privacidad, que debes revisar por separado.

Intercambio con terceros

El servidor MCP no comparte datos con ningún tercero. Los datos fluyen solo entre tu entorno local y la API pública de Capital.com, sujeto a la propia Política de privacidad de Capital.com.

Retención de datos

El servidor MCP no retiene ningún dato. Los datos de la sesión existen solo en memoria durante la duración de la sesión.

Credenciales de API

Las credenciales de API que proporcionas se almacenan y gestionan en tu entorno local. Eres responsable de asegurarlas adecuadamente.

Contacto

Para consultas relacionadas con la privacidad sobre tu cuenta de Capital.com o sobre cómo Capital.com maneja tus datos, consulta la Política de privacidad de Capital.com o contacta con support@capital.com.

Descargo de responsabilidad: uso de la API pública de Capital.com con herramientas de terceros

Integración de terceros

Esta página describe cómo los clientes pueden conectar la API pública de Capital.com a software, herramientas o integraciones de terceros, incluidas las impulsadas por inteligencia artificial o modelos de lenguaje grandes ('LLM'). Cualquier software, herramienta o integración de terceros es independiente de Capital.com y no forma parte de los servicios de Capital.com. Capital.com no controla, desarrolla, respalda ni acepta responsabilidad alguna por software de terceros, su funcionalidad, resultados o cualquier consecuencia derivada de su uso. El uso de herramientas o integraciones de terceros en relación con la API pública de Capital.com es totalmente bajo tu propio riesgo. Eres responsable de revisar los términos, las políticas de privacidad y las prácticas de manejo de datos de cualquier herramienta de terceros que elijas usar.

Uso de la API pública

Tu uso de la API pública de Capital.com es totalmente bajo tu propio criterio y riesgo. Capital.com pone la API pública a disposición para fines informativos y de trading, pero no recomienda, respalda ni fomenta ningún uso, integración o estrategia de trading en particular. Eres el único responsable de cómo accedes y usas la API, incluidos los parámetros de cualquier orden enviada, la configuración de cualquier herramienta o sistema conectado y la interpretación de cualquier dato recibido. Capital.com no acepta responsabilidad por pérdidas o resultados no deseados derivados de tu uso de la API, ya sea accedida directamente o a través de herramientas de terceros. La disponibilidad, funcionalidad y especificaciones de la API pueden modificarse, limitarse en tasa, suspenderse o interrumpirse en cualquier momento sin previo aviso. Tu uso de la API pública está sujeto a los Términos y condiciones y los Términos de trading electrónico de Capital.com, que debes leer detenidamente antes de usar la API.

Servicio de Ejecución Única y Sin Asesoramiento de Inversión

Capital.com proporciona sus servicios sobre una base de ejecución únicamente. Operar con instrumentos financieros implica un riesgo significativo de pérdida. Nada en esta página, en la API pública, ni en cualquier software o integración de terceros constituye asesoramiento de inversión, una recomendación personal o una solicitud para comprar o vender cualquier instrumento financiero. Esto incluye cualquier resultado, señal, sugerencia o análisis generado por IA, herramientas basadas en LLM u otras herramientas automatizadas. Todas las decisiones de trading, incluyendo cualquier actividad automatizada o algorítmica, se toman bajo su propio riesgo y siguen siendo de su exclusiva responsabilidad. Capital.com no controla los resultados de herramientas de IA o basadas en LLM de terceros conectadas a la API pública y no puede garantizar que dichas herramientas no generen contenido que pueda interpretarse como asesoramiento de inversión o una recomendación personal. Cualquier resultado de este tipo no es proporcionado por Capital.com ni en su nombre y no debe considerarse como asesoramiento.

Riesgos del Trading Automatizado y Algorítmico

El uso de la API pública en relación con herramientas de trading automatizado o algorítmico conlleva riesgos adicionales, incluyendo, entre otros: ejecución rápida de órdenes sin revisión o intervención humana; errores del sistema, fallos de software o problemas de conectividad; ejecución a precios materialmente diferentes de los esperados; y órdenes no intencionadas o erróneas resultantes de herramientas o parámetros mal configurados. Capital.com no es responsable de ninguna pérdida derivada de dichos riesgos o de la interacción entre sus sistemas y cualquier herramienta de terceros. El rendimiento pasado y cualquier resultado generado por herramientas automatizadas no son indicativos de resultados futuros.

Cuando se utilizan herramientas de IA o basadas en LLM para recuperar datos de mercado o información de precios, puede haber un retraso entre el precio comunicado por la herramienta y el precio al que se ejecuta cualquier orden resultante. Todas las órdenes realizadas a través de la API pública se ejecutan como órdenes de mercado. El precio de ejecución puede, por tanto, diferir de cualquier precio mostrado en el momento de una solicitud. Capital.com busca lograr la mejor ejecución de acuerdo con sus obligaciones; no aceptamos responsabilidad por diferencias de precio derivadas de la latencia atribuible a herramientas o sistemas de terceros fuera de su control.

Uso Prohibido

El uso de la API pública y cualquier herramienta conectada no debe utilizarse para manipular la plataforma de Capital.com, explotar precios o latencia, participar en abuso de mercado u obtener cualquier ventaja injusta. Capital.com se reserva el derecho de restringir, suspender o terminar el acceso a la API y/o su cuenta cuando considere razonablemente que dicho uso indebido ha ocurrido o es probable que ocurra. Los clientes no deben permitir que ningún tercero ejerza control discrecional sobre su cuenta.

Sus Responsabilidades

Usted es responsable de garantizar que su uso de la plataforma de Capital.com, la API pública y cualquier herramienta o integración de terceros cumpla con los Términos y Condiciones de Capital.com, los Términos de Trading Electrónico y todas las leyes y regulaciones aplicables en su jurisdicción. Debe considerar cuidadosamente si las herramientas de trading automatizado son apropiadas para sus circunstancias, experiencia y tolerancia al riesgo antes de utilizarlas. Capital.com recomienda encarecidamente que pruebe cualquier herramienta o integración automatizada a fondo utilizando una cuenta Demo antes de conectarlas a un entorno de trading en vivo.