Capital.com Public API MCP Server

Capital.com MCP Server

Servidor del Protocolo de Contexto de Modelo (MCP) para la API Abierta de Capital.com, que permite el acceso impulsado por LLM a su cuenta de trading de Capital.com.

⚠️ Aviso Importante

El uso de la API Pública de Capital.com y de cualquier herramienta de terceros que conecte a ella, incluidas herramientas basadas en IA o LLM, es bajo su propia discreción y riesgo. Capital.com opera únicamente en régimen de ejecución y no controla, respalda ni acepta responsabilidad por ningún software de terceros, sus resultados o cualquier consecuencia derivada. Nada en esta página constituye asesoramiento de inversión ni una recomendación para operar. Usted es el único responsable de todas las decisiones de trading, configuraciones y actividad automatizada en su cuenta, y debe asegurarse de que su uso cumple con los Términos y Condiciones de Capital.com, los Términos de Trading Electrónico y todas las leyes aplicables en su jurisdicción.

Los Derivados de Criptomonedas no están disponibles para clientes minoristas registrados con Capital Com (UK) Ltd.

• Comience siempre con una cuenta Demo antes de considerar el trading real.
• El trading está deshabilitado por defecto y requiere configuración explícita.
• Todas las operaciones de trading requieren ejecución en dos fases (previsualizar → confirmar → ejecutar).
• Controles de riesgo integrados: listas de permitidos, límites de tamaño, topes diarios de órdenes.
• Úselo bajo su propio riesgo - los autores no asumen ninguna responsabilidad por pérdidas de trading.

Para más preguntas/aclaraciones, consulte 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: Obtener Credenciales de la API de Capital.com

1. Crear Cuenta: Vaya a capital.com/trading/signup

   • Elija cuenta Demo para pruebas (recomendado)
   • Verifique su correo electrónico

2. Habilitar 2FA: Configuración > Seguridad > Autenticación de Dos Factores

   • Requerido antes de generar claves API

3. Generar Clave API: Configuración > Integraciones API > Generar nueva clave

   • Establezca una etiqueta (ej., "Servidor MCP")
   • Establezca una contraseña personalizada (esta NO es su contraseña de la plataforma)
   • ¡Guarde la clave API mostrada (se muestra solo una vez!)
   • Nota: Las claves API tienen capacidad de trading; Capital.com no ofrece claves de solo lectura

Paso 2: Instalar y Configurar

Tiene dos opciones de instalación:

Opción A: Instalación en Un Clic mediante Paquete MCPB (Recomendado)

El repositorio incluye un manifest.json que se ajusta a la especificación MCPB (Paquete MCP) — el estándar abierto de Anthropic para empaquetar servidores MCP locales. Esto le permite instalar el servidor en Claude Desktop (y otros clientes compatibles con MCPB) sin editar manualmente archivos de configuración.

Prerrequisitos: uv (el servidor usa uv como su entorno de ejecución — instálelo con brew install uv o consulte la documentación de uv).

Pasos:

1. Clone el repositorio y construya el paquete .mcpb (requiere Node.js para npx):

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

2. Abra capital-mcp.mcpb en Claude Desktop (doble clic, o arrástrelo a la aplicación).
3. Claude Desktop le pedirá los valores de configuración de usuario (clave API, identificador, contraseña, controles de trading). Rellénelos y haga clic en Instalar.
4. Reinicie Claude Desktop y verifique preguntando: "¿Qué herramientas de Capital.com están disponibles?"

Consulte la referencia de CLI de MCPB para comandos adicionales (validate, info, unpack, sign).

Opción B: Instalación Manual mediante Script

Prerrequisitos: 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 (marque "Agregar a 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 para usted.

Edite .env con sus 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

Paso 3: Probar el Servidor Localmente

Mac/Linux:

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

Windows (PowerShell):

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

Debería ver:

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

Presione Ctrl+C para detener.

Solución de Problemas: Revisar Registros

Si encuentra problemas al usar el servidor MCP con Claude Desktop u otros clientes, revise 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

Nota: Reemplace /path/to/capital-mcp/venv/bin/python con su ruta real de Python del entorno virtual. El script de instalación imprime esto para usted. En Windows, use C:\path\to\capital-mcp\venv\Scripts\python.exe.

Claude Desktop

💡 Consejo: Si instaló mediante el paquete MCPB (Opción A arriba), omita esta sección — Claude Desktop escribe la configuración por usted basándose en manifest.json. Use esta sección solo para instalaciones manuales con script.

macOS/Linux

Ubicación de la configuración: ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) o ~/.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": ""
      }
    }
  }
}

Reinicie Claude Desktop. Verifique escribiendo: "¿Qué herramientas de Capital.com están disponibles?"

Windows

Ubicación de la configuración: %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": ""
      }
    }
  }
}

Reinicie Claude Desktop.

Claude Code

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

Cursor IDE

Abra Configuración (Cmd+, / Ctrl+,) > Extensiones > MCP > Configurar. Agregue:

{
  "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"
    }
  }
}

Reinicie Cursor.

Codex

Configuración > Servidores MCP > Agregar servidor. Use el mismo comando, argumentos y variables de entorno que arriba.

Windsurf

Cree/edite ~/.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"
      }
    }
  }
}

Reinicie Windsurf.

Clientes MCP Personalizados

Cualquier cliente MCP con capacidad STDIO funciona. Ejemplo con 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

Ejemplos de Uso

Conversación de Ejemplo 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 Trabajo de Ejecución de Trading (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 (por defecto: demo)
• CAP_API_KEY - Clave API de Capital.com
• CAP_IDENTIFIER - Correo electrónico de inicio de sesión
• CAP_API_PASSWORD - Contraseña personalizada de la clave API

Controles de Riesgo (Recomendados)

• CAP_ALLOW_TRADING - Habilitar trading (por defecto: false)
• CAP_ALLOWED_EPICS - Lista de permitidos separada por comas (ej., "SILVER,GOLD,BTCUSD") o "ALL" para 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 concurrentes (por defecto: 3)
• CAP_MAX_ORDERS_PER_DAY - Límite diario de órdenes (por defecto: 20)
• CAP_REQUIRE_EXPLICIT_CONFIRM - Requerir confirm=true (por defecto: true)
• CAP_DRY_RUN - Bloquear todas las ejecuciones de trading (por defecto: false)

Opcionales

• CAP_DEFAULT_ACCOUNT_ID - Cuenta por defecto después de iniciar 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)

Herramientas MCP (36 implementadas)

Sesión (4)

• cap_session_status - Obtener información de sesión
• cap_session_login - Crear sesión
• cap_session_ping - Mantener viva
• cap_session_logout - Finalizar sesión

Datos de Mercado (6)

• cap_market_search - Buscar mercados
• cap_market_get - Obtener detalles del mercado
• cap_market_prices - Precios históricos
• cap_market_sentiment - Sentimiento del cliente
• cap_market_navigation_root - Raíz de categorías de mercado
• cap_market_navigation_node - Nodo de categorías de mercado

Cuenta (6)

• cap_account_list - Listar cuentas
• cap_account_preferences_get - Obtener preferencias
• cap_account_preferences_set - Establecer preferencias
• cap_account_history_activity - Historial de actividad
• cap_account_history_transactions - Historial de transacciones
• cap_account_demo_topup - Recargar cuenta demo

Trading (11)

• Solo lectura:

  • cap_trade_positions_list - Listar posiciones
  • cap_trade_positions_get - Obtener detalles de posición
  • cap_trade_orders_list - Listar órdenes pendientes
  • cap_trade_confirm_get - Obtener estado de confirmación
  • cap_trade_confirm_wait - Esperar confirmación

• Previsualizar:

  • cap_trade_preview_position - Previsualizar posición
  • cap_trade_preview_working_order - Previsualizar orden

• Ejecutar:

  • cap_trade_execute_position - Ejecutar posición
  • cap_trade_execute_working_order - Ejecutar orden
  • cap_trade_positions_close - Cerrar posición
  • cap_trade_orders_cancel - Cancelar orden

Listas de Seguimiento (6)

• cap_watchlists_list - Listar listas de seguimiento
• cap_watchlists_create - Crear lista de seguimiento
• cap_watchlists_get - Obtener lista de seguimiento
• cap_watchlists_add_market - Agregar mercado
• cap_watchlists_delete - Eliminar lista de seguimiento
• cap_watchlists_remove_market - Quitar mercado

Transmisión en Tiempo Real (3)

• cap_stream_prices - Transmitir precios en tiempo real (WebSocket)
• cap_stream_alerts - Transmitir alertas de nivel de precio (WebSocket)
• cap_stream_portfolio - Transmitir P&L de cartera en vivo (WebSocket)

Prompts MCP (Plantillas de Flujo de Trabajo)

Los prompts MCP son flujos de trabajo estructurados que guían a Claude a través de operaciones de trading complejas de varios pasos. Proporcionan instrucciones paso a paso y mejores prácticas para tareas comunes.

Prompts Disponibles (7)

1. market_scan - Flujo de Trabajo de Análisis de Mercado

Le guía a través del escaneo de una lista de seguimiento en busca de condiciones de trading.

Parámetros:

• watchlist_id - Lista de seguimiento a escanear (deje vacío para listar primero las listas de seguimiento)
• timeframe - Resolución de precio: MINUTE, MINUTE_5, HOUR, DAY (por defecto: HOUR)
• lookback_periods - Número de velas a obtener: 1-1000 (por defecto: 24)

Flujo de Trabajo:

1. Obtener mercados de la lista de seguimiento
2. Obtener datos de precios para cada mercado
3. Análisis técnico (tendencias, soporte/resistencia, patrones)
4. Verificación de sentimiento opcional
5. Generar resumen de oportunidades

Ejemplo de Uso:

• "Usa el prompt market_scan para analizar mi lista de seguimiento"
• "Escanea mis mercados en busca de configuraciones de trading"

Trading real: Cambie sus configuraciones a: CAP_ENV: 'live', CAP_ALLOW_TRADING: 'true'

2. trade_proposal - Flujo de Trabajo de Planificación de Trading

Le guía en la creación de una propuesta de trading con herramientas de gestión de riesgos.

Parámetros:

• epic - Mercado a operar (requerido, ej., SILVER, GOLD)
• direction - BUY o SELL (por defecto: BUY)
• thesis - Su razonamiento de trading (opcional)
• risk_percent - Riesgo como % del saldo (por defecto: 1.0%)

Flujo de Trabajo:

1. Obtener detalles del mercado y reglas de negociación
2. Calcular el tamaño de la posición basado en el % de riesgo
3. Definir niveles de stop loss y take profit
4. Previsualizar la operación (solo validación - sin ejecución)
5. Devolver preview_id para una posible ejecución

Ejemplo de Uso:

• "Crea una propuesta de trading para SILVER"
• "Propón una operación larga en GOLD con 2% de riesgo"

Nota: Este prompt NO ejecuta operaciones - solo crea previsualizaciones.

3. execute_trade - Flujo de Trabajo de Ejecución de Trading

Le guía en la ejecución de una operación previsualizada.

Parámetros:

• preview_id - ID de previsualización de trade_proposal (requerido)

Flujo de Trabajo:

1. Verificar que se proporciona preview_id y es válido
2. Volver a verificar todos los controles de riesgo
3. Ejecutar posición con el bróker
4. Sondear para confirmación (ACCEPTED/REJECTED)
5. Informar del estado final

Ejemplo de Uso:

• "Ejecuta la operación que acabo de previsualizar"
• "Coloca la operación con el ID de previsualización abc-123"

Nota:

• Requiere CAP_ALLOW_TRADING=true
• Requiere que el epic esté en la lista de permitidos
• La previsualización no debe estar caducada (TTL de 2 minutos)
• ⚠️ Esto SÍ realizará una operación real

4. position_review - Flujo de Trabajo de Análisis de Cartera

Le guía en el análisis de sus posiciones y órdenes abiertas.

Parámetros: Ninguno (analiza todas las posiciones actuales)

Flujo de Trabajo:

1. Obtener todas las posiciones abiertas
2. Obtener todas las órdenes pendientes
3. Calcular métricas de P&L, riesgo y exposición
4. Identificar riesgos de concentración y correlación
5. Sugerir ajustes potenciales (sin ejecutar)

Ejemplo de Uso:

• "Revisa mis posiciones actuales"
• "Analiza la exposición de mi cartera"

Nota: Este es un flujo de trabajo de solo lectura - no se ejecutan operaciones.

5. live_price_monitor - Seguimiento de Precios en Tiempo Real (WebSocket)

Monitoree los precios del mercado en vivo con alertas instantáneas cuando los precios se muevan más allá de un umbral.

Parámetros:

• epics - Lista de EPICs de mercado a monitorear (deje vacío para buscar/seleccionar, máx. 40)
• duration_minutes - Cuánto tiempo monitorear (por defecto: 5 minutos, máx.: 10 minutos)
• threshold_percent - Alertar cuando el precio se mueva > este % (por defecto: 1.0%)

Flujo de Trabajo:

1. Seleccionar mercados a monitorear (o proporcionar EPICs directamente)
2. Obtener precios iniciales para establecer línea base
3. Suscribirse a actualizaciones de precios en tiempo real por WebSocket
4. Mostrar panel de precios en vivo con actualizaciones continuas
5. Alertar cuando cualquier mercado se mueva > threshold_percent
6. Detenerse automáticamente después de duration_minutes

Ejemplo de Uso:

• "Monitorea los precios de GOLD y SILVER durante 2 minutos"
• "Observa BTC durante los próximos 5 minutos, alerta sobre movimientos del 2%" Nota: Requiere CAP_WS_ENABLED=true. Las sesiones WebSocket de Capital.com duran un máximo de 10 minutos.

6. real_time_alerts - Alertas de Precio Condicionales (WebSocket)

Establezca alertas de nivel de precio y reciba notificaciones instantáneas cuando los mercados alcancen sus objetivos.

Parámetros:

• alert_config - Niveles de alerta por EPIC (ej., {"GOLD": 2050.0, "SILVER": 28.5})
• duration_minutes - Duración máxima de monitoreo (predeterminado: 5 minutos)
• auto_stop - ¿Detener monitoreo tras primera alerta? (predeterminado: true)

Flujo de trabajo:

1. Configurar condiciones de alerta (niveles de precio para cada mercado)
2. Suscribirse a actualizaciones de precio WebSocket
3. Monitorear continuamente los disparadores de alerta
4. Emitir alerta instantánea cuando se cumpla la condición
5. Opcionalmente continuar monitoreando o detenerse tras la primera alerta

Ejemplo de uso:

• "Avísame cuando GOLD alcance 2050"
• "Notificar cuando SILVER caiga por debajo de 28"

Nota: Requiere CAP_WS_ENABLED=true.

7. live_portfolio_monitor - Seguimiento de P&L en Tiempo Real (WebSocket)

Observe cómo se actualiza el P&L de su cartera en tiempo real a medida que los precios del mercado se mueven.

Parámetros:

• duration_minutes - Duración del monitoreo (predeterminado: 5 minutos, máx.: 10 minutos)
• alert_pnl_threshold - Alertar cuando el P&L total supere esta cantidad (predeterminado: $100)

Flujo de trabajo:

1. Obtener posiciones abiertas actuales
2. Suscribirse a actualizaciones de precio para los mercados de las posiciones
3. Calcular P&L en vivo a medida que cambian los precios
4. Mostrar panel de cartera en tiempo real
5. Alertar cuando el P&L cruce el umbral

Ejemplo de uso:

• "Monitorea el P&L de mi cartera durante 5 minutos"
• "Observa posiciones en tiempo real, alerta a $500 de P&L"

Nota: Requiere CAP_WS_ENABLED=true y posiciones activas.

Cómo Usar Prompts

En Claude Desktop u otros clientes MCP, los prompts aparecen como patrones de interacción disponibles. Puede invocarlos de forma natural en la conversación:

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]

Los prompts proporcionan orientación estructurada mientras mantienen los controles de trading durante todo el flujo de trabajo.

Recursos MCP (Datos de Solo Lectura)

Los recursos MCP proporcionan acceso de solo lectura al estado y configuración del servidor a través de recursos basados en URI. A diferencia de las herramientas (que realizan acciones), los recursos exponen datos que los clientes pueden leer y monitorear.

Recursos Disponibles

1. cap://status - Estado del Servidor

Información del servidor y la sesión en tiempo real.

Devuelve: JSON con salud del servidor, estado de la sesión, estado de autenticación, límites de tasa

Ejemplo:

{
  "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"
  }
}

Casos de uso: Monitorear salud del servidor, verificar estado de la sesión, depurar problemas de autenticación

---

2. cap://risk-policy - Política de Riesgo

Configuración integral de gestión de riesgos y controles de trading.

Devuelve: JSON con todas las capas de validación, características de control de trading y restricciones de trading

Ejemplo:

{
  "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
  }
}

Casos de uso: Entender los controles de trading activos, auditar la configuración de riesgo, documentación de cumplimiento

---

3. cap://allowed-epics - Lista de Permitidos de Trading

Configuración actual de la lista de permitidos de trading que muestra los mercados permitidos.

Devuelve: JSON con modo de lista de permitidos, epics permitidos e instrucciones de configuración

Ejemplo:

{
  "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)"
  }
}

Casos de uso: Verificar qué mercados son negociables, comprobar la configuración de la lista de permitidos

---

4. cap://market-cache/{epic} - Detalles del Mercado (Dinámico)

Detalles del mercado en caché para un epic específico (obtención en vivo del bróker).

Parámetros:

• epic - Identificador de mercado (ej., "GOLD", "SILVER", "CS.D.EURUSD.TODAY.IP")

Devuelve: JSON con información completa del mercado

Autenticación: Requerida

Ejemplo: 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"
}

Casos de uso: Obtener detalles del mercado, verificar reglas de trading, analizar requisitos de margen

---

Cómo Usar Recursos

En Claude Desktop u otros clientes MCP, se puede acceder a los recursos por URI:

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]

Los recursos proporcionan una forma conveniente de inspeccionar el estado y la configuración del servidor sin ejecutar herramientas. Para datos de listas de seguimiento, use las herramientas cap_watchlists_list y cap_watchlists_get.

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: Validar la operación contra las reglas del bróker + política de riesgo local

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

2. Ejecutar: Enviar la operación usando preview_id

   • Vuelve a ejecutar verificaciones 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 negociar EPICs en CAP_ALLOWED_EPICS
• Límites de Tamaño: Se aplica 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ín/máx/incremento del bróker
• Modo 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

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 aquellas impulsadas por inteligencia artificial o modelos de lenguaje de gran tamaño ('LLMs'). Dicho 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 ninguna responsabilidad por ningún software de terceros, su funcionalidad, resultados o cualquier consecuencia derivada de su uso. Cualquier uso de herramientas o integraciones de terceros en conexión con la API Pública de Capital.com es bajo su propio riesgo. Usted es responsable de revisar los términos, políticas de privacidad y prácticas de manejo de datos de cualquier herramienta de terceros que elija usar.

Uso de la API Pública

Su uso de la API Pública de Capital.com es bajo su propia discreción y riesgo. Capital.com pone la API Pública 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. Usted es el único responsable de cómo accede y utiliza 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 ninguna responsabilidad por pérdidas o resultados no deseados que surjan de su 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 ser modificadas, limitadas por tasa, suspendidas o descontinuadas en cualquier momento sin previo aviso. Su uso de la API Pública está sujeto a los Términos y Condiciones y Términos de Trading Electrónico de Capital.com, los cuales debe leer detenidamente antes de usar la API.

Servicio de Solo Ejecución y Sin Asesoramiento de Inversión Capital.com proporciona sus servicios sobre una base de solo ejecución. Operar con instrumentos financieros implica un riesgo significativo de pérdida. Nada en esta página, en la API Pública o en cualquier 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 su propio riesgo y siguen siendo de su exclusiva responsabilidad. Riesgos del Trading Automatizado y Algorítmico El uso de la API Pública en conexión con herramientas de trading automatizado o algorítmico conlleva riesgos adicionales, que incluyen, 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 deseadas o erróneas resultantes de herramientas o parámetros mal configurados. Capital.com no es responsable de ninguna pérdida que surja 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.

Uso Prohibido

El uso de la API Pública y cualquier herramienta conectada no debe usarse 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 asegurarse de 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 usarlas. Capital.com recomienda encarecidamente que pruebe cualquier herramienta o integración automatizada exhaustivamente utilizando una cuenta Demo antes de conectarlas a un entorno de trading real.