Capital.com Public API MCP Server

Capital.com MCP Server

Servidor Model Context Protocol (MCP) para a API Open da Capital.com - permitindo acesso orientado por LLM à sua conta de trading na Capital.com.

⚠️ Aviso Importante

O uso da API Pública da Capital.com e de quaisquer ferramentas de terceiros que você conecte a ela, incluindo ferramentas baseadas em IA ou LLM, é de sua exclusiva discrição e risco. A Capital.com opera apenas em regime de execução e não controla, endossa ou aceita responsabilidade por qualquer software de terceiros, seus resultados ou quaisquer consequências decorrentes. Nada nesta página constitui aconselhamento de investimento ou recomendação para negociar. Você é o único responsável por todas as decisões de trading, configurações e atividades automatizadas em sua conta, e deve garantir que seu uso esteja em conformidade com os Termos e Condições da Capital.com, Termos de Negociação Eletrônica e todas as leis aplicáveis em sua jurisdição.

Derivativos de Criptomoedas não estão disponíveis para clientes de Varejo registrados na Capital Com (UK) Ltd.

• Sempre comece com uma conta Demo antes de considerar trading real
• O trading está desabilitado por padrão e requer configuração explícita
• Todas as operações de trading requerem execução em duas fases (pré-visualizar → confirmar → executar)
• Controles de risco integrados: listas de permissão, limites de tamanho, limites diários de ordens
• Use por sua conta e risco - os autores não assumem responsabilidade por perdas de trading

Para mais perguntas/esclarecimentos, consulte o FAQ: https://help.capitalccuk.com/hc/en-us/articles/34503231743506-How-to-set-up-the-Capital-com-MCP-Server

Guia de Início Rápido

Passo 1: Obter Credenciais da API Capital.com

1. Criar Conta: Acesse capital.com/trading/signup

   • Escolha a conta Demo para testes (recomendado)
   • Verifique seu e-mail

2. Habilitar 2FA: Configurações > Segurança > Autenticação de Dois Fatores

   • Necessário antes de gerar chaves de API

3. Gerar Chave de API: Configurações > Integrações de API > Gerar nova chave

   • Defina um rótulo (ex., "Servidor MCP")
   • Defina uma senha personalizada (esta NÃO é a senha da sua plataforma)
   • Salve a chave de API exibida (mostrada apenas uma vez!)
   • Nota: As chaves de API têm capacidade de trading; a Capital.com não oferece chaves somente leitura

Passo 2: Instalar e Configurar

Você tem duas opções de instalação:

Opção A: Instalação com Um Clique via Pacote MCPB (Recomendado)

O repositório inclui um manifest.json que está em conformidade com a especificação MCPB (MCP Bundle) — o padrão aberto da Anthropic para empacotar servidores MCP locais. Isso permite instalar o servidor no Claude Desktop (e outros clientes compatíveis com MCPB) sem editar manualmente os arquivos de configuração.

Pré-requisitos: uv (o servidor usa uv como seu ambiente de execução — instale com brew install uv ou veja a documentação do uv).

Passos:

1. Clone o repositório e construa o pacote .mcpb (requer 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 no Claude Desktop (clique duas vezes ou arraste-o para o aplicativo).
3. O Claude Desktop solicitará os valores de configuração do usuário (chave de API, identificador, senha, controles de trading). Preencha-os e clique em Instalar.
4. Reinicie o Claude Desktop e verifique perguntando: "Quais ferramentas da Capital.com estão disponíveis?"

Veja a referência da CLI MCPB para comandos adicionais (validate, info, unpack, sign).

Opção B: Instalação Manual via Script

Pré-requisitos: Python 3.10+ e Git devem estar instalados.

• macOS: brew install python3 git
• Ubuntu/Debian: sudo apt install python3 python3-venv git
• Windows: python.org (marque "Adicionar ao PATH" durante a instalação) + git-scm.com

Mac/Linux:

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

Windows (PowerShell):

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

O script de instalação criará um ambiente virtual, instalará as dependências e exibirá a configuração do cliente MCP para você.

Edite .env com suas credenciais:

# 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

Passo 3: Testar o Servidor Localmente

Mac/Linux:

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

Windows (PowerShell):

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

Você deve ver:

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

Pressione Ctrl+C para parar.

Solução de Problemas: Verificar Logs

Se você encontrar problemas ao usar o servidor MCP com o Claude Desktop ou outros clientes, verifique os arquivos de log:

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

---

Integração

Nota: Substitua /path/to/capital-mcp/venv/bin/python pelo caminho real do Python do seu ambiente virtual. O script de instalação exibe isso para você. No Windows, use C:\path\to\capital-mcp\venv\Scripts\python.exe.

Claude Desktop

💡 Dica: Se você instalou via pacote MCPB (Opção A acima), pule esta seção — o Claude Desktop grava a configuração para você com base em manifest.json. Use esta seção apenas para instalações manuais via script.

macOS/Linux

Local da configuração: ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) ou ~/.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 o Claude Desktop. Verifique digitando: "Quais ferramentas da Capital.com estão disponíveis?"

Windows

Local da configuração: %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 o Claude Desktop.

Claude Code

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

Cursor IDE

Abra Configurações (Cmd+, / Ctrl+,) > Extensões > MCP > Configurar. Adicione:

{
  "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 o Cursor.

Codex

Configurações > Servidores MCP > Adicionar servidor. Use o mesmo comando, argumentos e variáveis de ambiente acima.

Windsurf

Crie/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 o Windsurf.

Clientes MCP Personalizados

Qualquer cliente MCP compatível com STDIO funciona. Exemplo com 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

Exemplos de Uso

Exemplo de Conversa com o 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

Fluxo de Trabalho de Execução de Trade (Quando Trading 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"

Referência de Variáveis de Ambiente

Obrigatórias

• CAP_ENV - Ambiente: demo ou live (padrão: demo)
• CAP_API_KEY - Chave de API da Capital.com
• CAP_IDENTIFIER - E-mail de login
• CAP_API_PASSWORD - Senha personalizada da chave de API

Controles de Risco (Recomendado)

• CAP_ALLOW_TRADING - Habilitar trading (padrão: false)
• CAP_ALLOWED_EPICS - Lista de permissão separada por vírgulas (ex., "SILVER,GOLD,BTCUSD") ou "ALL" para irrestrito
• CAP_MAX_POSITION_SIZE - Tamanho máximo da posição (padrão: 1.0)
• CAP_MAX_WORKING_ORDER_SIZE - Tamanho máximo da ordem (padrão: 1.0)
• CAP_MAX_OPEN_POSITIONS - Máximo de posições simultâneas (padrão: 3)
• CAP_MAX_ORDERS_PER_DAY - Limite diário de ordens (padrão: 20)
• CAP_REQUIRE_EXPLICIT_CONFIRM - Exigir confirm=true (padrão: true)
• CAP_DRY_RUN - Bloquear todas as execuções de trade (padrão: false)

Opcionais

• CAP_DEFAULT_ACCOUNT_ID - Conta padrão após o login
• CAP_HTTP_TIMEOUT_S - Tempo limite HTTP (padrão: 15)
• CAP_LOG_LEVEL - Nível de log: DEBUG, INFO, WARNING, ERROR (padrão: INFO)

Ferramentas MCP (36 implementadas)

Sessão (4)

• cap_session_status - Obter informações da sessão
• cap_session_login - Criar sessão
• cap_session_ping - Manter ativa
• cap_session_logout - Encerrar sessão

Dados de Mercado (6)

• cap_market_search - Pesquisar mercados
• cap_market_get - Obter detalhes do mercado
• cap_market_prices - Preços históricos
• cap_market_sentiment - Sentimento do cliente
• cap_market_navigation_root - Raiz de categorias de mercado
• cap_market_navigation_node - Nó de categorias de mercado

Conta (6)

• cap_account_list - Listar contas
• cap_account_preferences_get - Obter preferências
• cap_account_preferences_set - Definir preferências
• cap_account_history_activity - Histórico de atividades
• cap_account_history_transactions - Histórico de transações
• cap_account_demo_topup - Recarregar conta demo

Trading (11)

• Somente leitura:

  • cap_trade_positions_list - Listar posições
  • cap_trade_positions_get - Obter detalhes da posição
  • cap_trade_orders_list - Listar ordens ativas
  • cap_trade_confirm_get - Obter status de confirmação
  • cap_trade_confirm_wait - Aguardar confirmação

• Pré-visualização:

  • cap_trade_preview_position - Pré-visualizar posição
  • cap_trade_preview_working_order - Pré-visualizar ordem

• Executar:

  • cap_trade_execute_position - Executar posição
  • cap_trade_execute_working_order - Executar ordem
  • cap_trade_positions_close - Fechar posição
  • cap_trade_orders_cancel - Cancelar ordem

Listas de Observação (6)

• cap_watchlists_list - Listar listas de observação
• cap_watchlists_create - Criar lista de observação
• cap_watchlists_get - Obter lista de observação
• cap_watchlists_add_market - Adicionar mercado
• cap_watchlists_delete - Excluir lista de observação
• cap_watchlists_remove_market - Remover mercado

Streaming (3)

• cap_stream_prices - Transmitir preços em tempo real (WebSocket)
• cap_stream_alerts - Transmitir alertas de nível de preço (WebSocket)
• cap_stream_portfolio - Transmitir P&L do portfólio ao vivo (WebSocket)

Prompts MCP (Modelos de Fluxo de Trabalho)

Prompts MCP são fluxos de trabalho estruturados que guiam o Claude através de operações de trading complexas de várias etapas. Eles fornecem instruções passo a passo e melhores práticas para tarefas comuns.

Prompts Disponíveis (7)

1. market_scan - Fluxo de Trabalho de Análise de Mercado

Guia você na varredura de uma lista de observação em busca de condições de trading.

Parâmetros:

• watchlist_id - Lista de observação para varrer (deixe vazio para listar as listas primeiro)
• timeframe - Resolução de preço: MINUTE, MINUTE_5, HOUR, DAY (padrão: HOUR)
• lookback_periods - Número de velas para buscar: 1-1000 (padrão: 24)

Fluxo de Trabalho:

1. Obter mercados da lista de observação
2. Buscar dados de preço para cada mercado
3. Análise técnica (tendências, suporte/resistência, padrões)
4. Verificação de sentimento opcional
5. Gerar resumo de oportunidades

Exemplo de Uso:

• "Use o prompt market_scan para analisar minha lista de observação"
• "Varrer meus mercados em busca de configurações de trading"

Trading real: Altere suas configurações para: CAP_ENV: 'live', CAP_ALLOW_TRADING: 'true'

2. trade_proposal - Fluxo de Trabalho de Planejamento de Trade

Guia você na criação de uma proposta de trade com ferramentas de gerenciamento de risco.

Parâmetros:

• epic - Mercado para negociar (obrigatório, ex., SILVER, GOLD)
• direction - BUY ou SELL (padrão: BUY)
• thesis - Seu raciocínio de trading (opcional)
• risk_percent - Risco como % do saldo (padrão: 1.0%)

Fluxo de Trabalho:

1. Buscar detalhes do mercado e regras de negociação
2. Calcular o tamanho da posição com base no % de risco
3. Definir níveis de stop loss e take profit
4. Pré-visualizar o trade (apenas validação - sem execução)
5. Retornar preview_id para potencial execução

Exemplo de Uso:

• "Criar uma proposta de trade para SILVER"
• "Propor um trade longo em GOLD com 2% de risco"

Nota: Este prompt NÃO executa trades - apenas cria pré-visualizações.

3. execute_trade - Fluxo de Trabalho de Execução de Trade

Guia você na execução de um trade pré-visualizado.

Parâmetros:

• preview_id - ID de pré-visualização do trade_proposal (obrigatório)

Fluxo de Trabalho:

1. Verificar se preview_id foi fornecido e é válido
2. Verificar novamente todos os controles de risco
3. Executar posição com a corretora
4. Pesquisar por confirmação (ACCEPTED/REJECTED)
5. Relatar status final

Exemplo de Uso:

• "Executar o trade que acabei de pré-visualizar"
• "Colocar o trade com o ID de pré-visualização abc-123"

Nota:

• Requer CAP_ALLOW_TRADING=true
• Requer epic na lista de permissão
• A pré-visualização não deve estar expirada (TTL de 2 minutos)
• ⚠️ Isso IRÁ colocar um trade real

4. position_review - Fluxo de Trabalho de Análise de Portfólio

Guia você na análise de suas posições e ordens abertas.

Parâmetros: Nenhum (analisa todas as posições atuais)

Fluxo de Trabalho:

1. Buscar todas as posições abertas
2. Buscar todas as ordens ativas
3. Calcular P&L, risco e métricas de exposição
4. Identificar riscos de concentração e correlação
5. Sugerir ajustes potenciais (sem executar)

Exemplo de Uso:

• "Revisar minhas posições atuais"
• "Analisar minha exposição de portfólio"

Nota: Este é um fluxo de trabalho somente leitura - nenhum trade é executado.

5. live_price_monitor - Rastreamento de Preços em Tempo Real (WebSocket)

Monitore preços de mercado ao vivo com alertas instantâneos quando os preços se moverem além de um limite.

Parâmetros:

• epics - Lista de EPICs de mercado para monitorar (deixe vazio para pesquisar/selecionar, máx. 40)
• duration_minutes - Por quanto tempo monitorar (padrão: 5 minutos, máx.: 10 minutos)
• threshold_percent - Alertar quando o preço mover > este % (padrão: 1.0%)

Fluxo de Trabalho:

1. Selecionar mercados para monitorar (ou fornecer EPICs diretamente)
2. Buscar preços iniciais para estabelecer linha de base
3. Inscrever-se para atualizações de preço WebSocket em tempo real
4. Exibir painel de preços ao vivo com atualizações contínuas
5. Alertar quando qualquer mercado mover > threshold_percent
6. Parar automaticamente após duration_minutes

Exemplo de Uso:

• "Monitorar preços de GOLD e SILVER por 2 minutos"
• "Observar BTC pelos próximos 5 minutos, alertar em movimentos de 2%" Nota: Requer CAP_WS_ENABLED=true. As sessões WebSocket da Capital.com duram no máximo 10 minutos.

6. real_time_alerts - Alertas de Preço Condicionais (WebSocket)

Defina alertas de nível de preço e receba notificações instantâneas quando os mercados atingirem seus objetivos.

Parâmetros:

• alert_config - Níveis de alerta por EPIC (ex., {"GOLD": 2050.0, "SILVER": 28.5})
• duration_minutes - Duração máxima do monitoramento (padrão: 5 minutos)
• auto_stop - Parar monitoramento após o primeiro alerta? (padrão: true)

Fluxo de Trabalho:

1. Configurar condições de alerta (níveis de preço para cada mercado)
2. Assinar atualizações de preço via WebSocket
3. Monitorar continuamente os gatilhos de alerta
4. Emitir alerta instantâneo quando a condição for atendida
5. Opcionalmente, continuar monitorando ou parar após o primeiro alerta

Exemplos de Uso:

• "Avise-me quando OURO atingir 2050"
• "Notifique quando PRATA cair abaixo de 28"

Nota: Requer CAP_WS_ENABLED=true.

7. live_portfolio_monitor - Rastreamento de Lucros e Perdas em Tempo Real (WebSocket)

Acompanhe o P&L do seu portfólio sendo atualizado em tempo real conforme os preços de mercado se movem.

Parâmetros:

• duration_minutes - Duração do monitoramento (padrão: 5 minutos, máx.: 10 minutos)
• alert_pnl_threshold - Alertar quando o P&L total exceder este valor (padrão: $100)

Fluxo de Trabalho:

1. Buscar posições abertas atuais
2. Assinar atualizações de preço para os mercados das posições
3. Calcular P&L ao vivo conforme os preços mudam
4. Exibir painel do portfólio em tempo real
5. Alertar quando o P&L cruzar o limite

Exemplos de Uso:

• "Monitore o P&L do meu portfólio por 5 minutos"
• "Observe posições em tempo real, alerte com P&L de $500"

Nota: Requer CAP_WS_ENABLED=true e posições ativas.

Como Usar Prompts

No Claude Desktop ou outros clientes MCP, os prompts aparecem como padrões de interação disponíveis. Você pode invocá-los naturalmente na conversa:

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]

Os prompts fornecem orientação estruturada, mantendo os controles de negociação durante todo o fluxo de trabalho.

Recursos MCP (Dados Somente Leitura)

Os recursos MCP fornecem acesso somente leitura ao estado e configuração do servidor por meio de recursos baseados em URI. Diferentemente das ferramentas (que executam ações), os recursos expõem dados que os clientes podem ler e monitorar.

Recursos Disponíveis

1. cap://status - Status do Servidor

Informações do servidor e da sessão em tempo real.

Retorna: JSON com saúde do servidor, estado da sessão, status de autenticação, limites de taxa

Exemplo:

{
  "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: Monitorar saúde do servidor, verificar status da sessão, depurar problemas de autenticação

---

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

Configuração abrangente de gerenciamento de risco e controles de negociação.

Retorna: JSON com todas as camadas de validação, recursos de controle de negociação e restrições de negociação

Exemplo:

{
  "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 controles de negociação ativos, auditar configuração de risco, documentação de conformidade

---

3. cap://allowed-epics - Lista de Permissões de Negociação

Configuração atual da lista de permissões de negociação mostrando os mercados permitidos.

Retorna: JSON com modo da lista de permissões, epics permitidos e instruções de configuração

Exemplo:

{
  "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 quais mercados são negociáveis, verificar configuração da lista de permissões

---

4. cap://market-cache/{epic} - Detalhes do Mercado (Dinâmico)

Detalhes de mercado em cache para um epic específico (busca ao vivo da corretora).

Parâmetros:

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

Retorna: JSON com informações abrangentes do mercado

Autenticação: Necessária

Exemplo: 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: Obter detalhes do mercado, verificar regras de negociação, analisar requisitos de margem

---

Como Usar Recursos

No Claude Desktop ou outros clientes MCP, os recursos podem ser acessados 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]

Os recursos fornecem uma maneira conveniente de inspecionar o estado e a configuração do servidor sem executar ferramentas. Para dados da lista de observação, use as ferramentas cap_watchlists_list e cap_watchlists_get.

Processo de Execução de Negociação

Execução Obrigatória em Duas Etapas

Todas as operações com efeitos colaterais usam um fluxo estrito de pré-visualização → execução:

1. Pré-visualizar: Validar negociação contra regras da corretora + política de risco local

   • Retorna preview_id com solicitação normalizada + verificações de risco
   • Sem efeitos colaterais, validação somente leitura

2. Executar: Enviar negociação usando preview_id

   • Reexecuta verificações críticas
   • Requer confirm=true se CAP_REQUIRE_EXPLICIT_CONFIRM=true
   • Consulta confirmação da corretora
   • Incrementa contador diário de ordens

Controles de Risco

• Lista de Permissões: Apenas EPICs em CAP_ALLOWED_EPICS podem ser negociados
• Limites de Tamanho: Tamanho máximo de posição/ordem aplicado
• Limites de Posição: Máximo de posições abertas a qualquer momento
• Limites Diários: Máximo de ordens por dia
• Normalização de Tamanho: Arredonda para mín./máx./incremento da corretora
• Modo de Simulação: Bloqueia todas as execuções quando ativado

Documentação

• Guia de Uso: USAGE.md - Guia de uso abrangente com exemplos
• Referência da API Capital.com: https://open-api.capital.com/
• Coleção Postman da API Capital.com: https://github.com/capital-com-sv/capital-api-postman

Licença

MIT

Aviso Legal – Uso da API Pública da Capital.com com Ferramentas de Terceiros

Integração com Terceiros

Esta página descreve como os clientes podem conectar a API Pública da Capital.com a softwares, ferramentas ou integrações de terceiros, incluindo aqueles alimentados por inteligência artificial ou grandes modelos de linguagem ('LLMs'). Qualquer software, ferramenta ou integração de terceiros é independente da Capital.com e não faz parte dos serviços da Capital.com. A Capital.com não controla, desenvolve, endossa ou aceita qualquer responsabilidade por qualquer software de terceiros, sua funcionalidade, resultados ou quaisquer consequências decorrentes de seu uso. Qualquer uso de ferramentas ou integrações de terceiros em conexão com a API Pública da Capital.com é inteiramente por sua conta e risco. Você é responsável por revisar os termos, políticas de privacidade e práticas de tratamento de dados de qualquer ferramenta de terceiros que optar por usar.

Uso da API Pública

O uso da API Pública da Capital.com é inteiramente a seu critério e risco. A Capital.com disponibiliza a API Pública para fins informativos e de negociação, mas não recomenda, endossa ou incentiva qualquer uso, integração ou estratégia de negociação específica. Você é o único responsável por como acessa e usa a API, incluindo os parâmetros de quaisquer ordens enviadas, a configuração de quaisquer ferramentas ou sistemas conectados e a interpretação de quaisquer dados recebidos. A Capital.com não aceita qualquer responsabilidade por perdas ou resultados não intencionais decorrentes do uso da API, seja acessada diretamente ou por meio de ferramentas de terceiros. A disponibilidade, funcionalidade e especificações da API podem ser modificadas, limitadas por taxa, suspensas ou descontinuadas a qualquer momento sem aviso prévio. O uso da API Pública está sujeito aos Termos e Condições e aos Termos de Negociação Eletrônica da Capital.com, que você deve ler atentamente antes de usar a API.

Serviço de Apenas Execução e Nenhum Conselho de Investimento A Capital.com fornece seus serviços apenas em regime de execução. A negociação de instrumentos financeiros envolve risco significativo de perda. Nada nesta página, na API Pública ou em qualquer software ou integração de terceiros constitui conselho de investimento, recomendação pessoal ou solicitação para comprar ou vender qualquer instrumento financeiro. Isso inclui qualquer resultado, sinal, sugestão ou análise gerada por IA, ferramentas baseadas em LLM ou outras ferramentas automatizadas. Todas as decisões de negociação, incluindo qualquer atividade automatizada ou algorítmica, são tomadas por sua conta e risco e permanecem sob sua exclusiva responsabilidade. Riscos da Negociação Automatizada e Algorítmica O uso da API Pública em conexão com ferramentas de negociação automatizada ou algorítmica acarreta riscos adicionais, incluindo, mas não se limitando a: execução rápida de ordens sem revisão ou intervenção humana; erros de sistema, falhas de software ou problemas de conectividade; execução a preços materialmente diferentes dos esperados; e ordens não intencionais ou errôneas resultantes de ferramentas ou parâmetros mal configurados. A Capital.com não se responsabiliza por quaisquer perdas decorrentes de tais riscos ou da interação entre seus sistemas e quaisquer ferramentas de terceiros. O desempenho passado e quaisquer resultados gerados por ferramentas automatizadas não são indicativos de resultados futuros.

Uso Proibido

O uso da API Pública e de quaisquer ferramentas conectadas não deve ser usado para manipular a plataforma Capital.com, explorar precificação ou latência, envolver-se em abuso de mercado ou obter qualquer vantagem indevida. A Capital.com reserva-se o direito de restringir, suspender ou encerrar o acesso à API e/ou sua conta quando considerar razoavelmente que tal uso indevido ocorreu ou é provável que ocorra. Os clientes não devem permitir que terceiros exerçam controle discricionário sobre sua conta.

Suas Responsabilidades

Você é responsável por garantir que o uso da plataforma Capital.com, da API Pública e de quaisquer ferramentas ou integrações de terceiros esteja em conformidade com os Termos e Condições da Capital.com, os Termos de Negociação Eletrônica e todas as leis e regulamentos aplicáveis em sua jurisdição. Você deve considerar cuidadosamente se as ferramentas de negociação automatizada são apropriadas para suas circunstâncias, experiência e tolerância ao risco antes de usá-las. A Capital.com recomenda fortemente que você teste minuciosamente quaisquer ferramentas ou integrações automatizadas usando uma conta Demo antes de conectá-las a um ambiente de negociação real.