Capital.com Public API MCP Server

Capital.com MCP Server

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

⚠️ Aviso importante

El uso de la Public API de Capital.com y de cualquier herramienta de terceros, incluidas las herramientas basadas en IA/LLM, es bajo tu propio riesgo. Capital.com es de solo ejecución y no respalda ni se hace responsable del software de terceros ni de sus resultados. Nada de lo aquí contenido constituye asesoramiento de inversión. Eres el único responsable de tus decisiones de trading, incluida cualquier diferencia de precio 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 de Demo antes de considerar el trading en vivo
• El trading está deshabilitado por defecto y requiere configuración explícita
• 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, límites diarios de órdenes
• Úsalo bajo tu propio riesgo: los autores no asumen ninguna 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 de Demo para probar (recomendado)
   • Verifica tu correo electrónico

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

   • Requerida antes de generar claves de API

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

   • Establece una etiqueta (p. ej., "MCP Server")
   • Establece una contraseña personalizada (esta NO es la contraseña de tu plataforma)
   • Guarda la clave de API mostrada (¡solo se muestra 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 del 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, no es necesario 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 (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

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, revisa 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 — Client Integration.

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

Obligatorias

• CAP_ENV - Entorno: demo o live (por defecto: demo)
• CAP_API_KEY - Clave de API de Capital.com
• CAP_IDENTIFIER - Correo 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 (por defecto: false)
• CAP_ALLOWED_EPICS - Lista de permitidos separada por comas (p. ej., "SILVER,GOLD,BTCUSD") o "ALL" para acceso sin restricciones
• CAP_MAX_POSITION_SIZE - Tamaño máximo de posición (por defecto: 1.0)
• CAP_MAX_WORKING_ORDER_SIZE - Tamaño máximo de orden (por defecto: 1.0)
• CAP_MAX_OPEN_POSITIONS - Máximo de posiciones simultáneas (por defecto: 3)
• CAP_MAX_ORDERS_PER_DAY - Límite diario de órdenes (por defecto: 20)
• CAP_REQUIRE_EXPLICIT_CONFIRM - Exigir confirm=true (por defecto: true)
• CAP_DRY_RUN - Bloquear todas las ejecuciones de trading (por defecto: false)

Opcionales

• CAP_DEFAULT_ACCOUNT_ID - Cuenta predeterminada tras el inicio de sesión
• CAP_HTTP_TIMEOUT_S - Tiempo de espera HTTP (por defecto: 15)
• CAP_LOG_LEVEL - Nivel de registro: DEBUG, INFO, WARNING, ERROR (por defecto: INFO)

Capacidades de MCP

38 herramientas en 6 categorías, 7 prompts de flujo de trabajo 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	Analizar una lista de seguimiento en busca de condiciones de trading
trade_proposal	Planificar una operación con dimensionamiento basado en riesgo (solo vista previa)
execute_trade	Ejecutar una operación previamente previsualizada
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 precio (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 obtener todos los detalles, 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 las 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 incluidos en CAP_ALLOWED_EPICS
• Límites de tamaño: Se aplica el tamaño máximo de posición/orden
• Límites de posiciones: 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 (dry-run): 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 Public API de Capital.com utilizando las credenciales que tú 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 Public API 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 al finalizar la sesión. El servidor MCP no escribe ningún dato en disco. Nota: tu cliente de IA puede procesar, registrar o almacenar los datos que pasan 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 únicamente entre tu entorno local y la Public API de Capital.com, sujetos 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 protegerlas 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 Public API de Capital.com con herramientas de terceros

Integración de terceros

Esta página describe cómo los clientes pueden conectar la Public API de Capital.com a software, herramientas o integraciones de terceros, incluidas aquellas 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 ningún software de terceros, su funcionalidad, sus resultados o cualquier consecuencia derivada de su uso. Cualquier uso de herramientas o integraciones de terceros en relación con la Public API de Capital.com es enteramente 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 decidas utilizar.

Uso de la Public API

Tu uso de la Public API de Capital.com es enteramente a tu propia discreción y riesgo. Capital.com pone la Public API a disposición con 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 utilizas 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 Public API está sujeto a los Términos y condiciones y a los Términos de trading electrónico de Capital.com, que debes leer atentamente antes de usar la API.

Servicio de solo ejecución y ausencia de asesoramiento de inversión

Capital.com presta sus servicios sobre una base de solo ejecución. El trading de instrumentos financieros implica un riesgo significativo de pérdida. Nada en esta página, en la Public API ni en ningún software o integración de terceros constituye asesoramiento de inversión, una recomendación personal o una solicitud para comprar o vender ningún 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, incluida cualquier actividad automatizada o algorítmica, se toman bajo tu propio riesgo y siguen siendo tu única responsabilidad. Capital.com no controla los resultados de las herramientas de IA o LLM de terceros conectadas a la Public API y no puede garantizar que dichas herramientas no generen contenido que pudiera 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 Public API en relación con herramientas de trading automatizado o algorítmico conlleva riesgos adicionales, incluidos, 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 las pérdidas derivadas de dichos riesgos ni 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 basadas en IA o 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 Public API se ejecutan como órdenes de mercado. Por lo tanto, el precio de ejecución puede diferir de cualquier precio mostrado en el momento de la 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 Public API 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 se ha producido o es probable que se produzca dicho uso indebido. 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 Public API y cualquier herramienta o integración de terceros cumpla con los Términos y Condiciones de Capital.com, los Términos de Negociación Electrónica 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 usarlas. 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.