Capital.com Public API MCP Server

Capital.com MCP Server

Сервер Model Context Protocol (MCP) для Capital.com Open API — предоставляет LLM-доступ к вашему торговому счету Capital.com.

⚠️ Важное уведомление

Использование Capital.com Public API и любых сторонних инструментов, подключаемых к нему, включая инструменты на базе ИИ или LLM, осуществляется по вашему собственному усмотрению и на ваш риск. Capital.com работает исключительно на основе исполнения заявок и не контролирует, не одобряет и не несет ответственности за любое стороннее программное обеспечение, его результаты или любые вытекающие последствия. Ничто на этой странице не является инвестиционной рекомендацией или советом по совершению сделок. Вы несете единоличную ответственность за все торговые решения, настройки и автоматическую активность на вашем счете и должны обеспечить соответствие вашего использования Условиям и положениям Capital.com, Условиям электронной торговли и всем применимым законам вашей юрисдикции.

Криптодеривативы недоступны розничным клиентам, зарегистрированным в Capital Com (UK) Ltd.

• Всегда начинайте с Демо-счета, прежде чем рассматривать реальную торговлю
• Торговля по умолчанию отключена и требует явной настройки
• Все торговые операции требуют двухэтапного выполнения (предпросмотр → подтверждение → исполнение)
• Встроенные средства контроля рисков: белые списки, лимиты размера, дневные лимиты ордеров
• Используйте на свой страх и риск — авторы не несут ответственности за торговые убытки

По дополнительным вопросам/уточнениям обращайтесь к FAQ: https://help.capitalccuk.com/hc/en-us/articles/34503231743506-How-to-set-up-the-Capital-com-MCP-Server

Краткое руководство по началу работы

Шаг 1: Получите учетные данные Capital.com API

1. Создайте аккаунт: Перейдите на capital.com/trading/signup

   • Выберите Демо-счет для тестирования (рекомендуется)
   • Подтвердите email

2. Включите 2FA: Настройки > Безопасность > Двухфакторная аутентификация

   • Требуется перед созданием ключей API

3. Создайте ключ API: Настройки > API интеграции > Создать новый ключ

   • Укажите метку (например, "MCP Server")
   • Установите пользовательский пароль (это НЕ ваш пароль от платформы)
   • Сохраните показанный ключ API (отображается только один раз!)
   • Примечание: ключи API позволяют торговать; Capital.com не предлагает ключи только для чтения

Шаг 2: Установка и настройка

У вас есть два варианта установки:

Вариант A: Установка в один клик через MCPB Bundle (рекомендуется)

Репозиторий поставляется с manifest.json, который соответствует спецификации MCPB (MCP Bundle) — открытому стандарту от Anthropic для упаковки локальных MCP-серверов. Это позволяет установить сервер в Claude Desktop (и другие MCPB-совместимые клиенты) без ручного редактирования файлов конфигурации.

Предварительные требования: uv (сервер использует uv в качестве среды выполнения — установите с помощью brew install uv или см. документацию uv).

Шаги:

1. Клонируйте репозиторий и соберите пакет .mcpb (требуется Node.js для npx):

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

2. Откройте capital-mcp.mcpb в Claude Desktop (двойной щелчок или перетащите в приложение).
3. Claude Desktop запросит пользовательские значения конфигурации (ключ API, идентификатор, пароль, элементы управления торговлей). Заполните их и нажмите «Установить».
4. Перезапустите Claude Desktop и проверьте, спросив: "Какие инструменты Capital.com доступны?"

См. справочник по CLI MCPB для дополнительных команд (validate, info, unpack, sign).

Вариант B: Ручная установка через скрипт

Предварительные требования: Должны быть установлены Python 3.10+ и Git.

• macOS: brew install python3 git
• Ubuntu/Debian: sudo apt install python3 python3-venv git
• Windows: python.org (отметьте "Add to PATH" при установке) + git-scm.com

Mac/Linux:

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

Windows (PowerShell):

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

Скрипт установки создаст виртуальное окружение, установит зависимости и выведет конфигурацию MCP-клиента для вас.

Отредактируйте .env с вашими учетными данными:

# 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

Шаг 3: Локальное тестирование сервера

Mac/Linux:

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

Windows (PowerShell):

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

Вы должны увидеть:

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

Нажмите Ctrl+C для остановки.

Устранение неполадок: Проверка журналов

Если у вас возникли проблемы при использовании MCP-сервера с Claude Desktop или другими клиентами, проверьте файлы журналов:

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

---

Интеграция

Примечание: Замените /path/to/capital-mcp/venv/bin/python на фактический путь к Python вашего venv. Скрипт установки выводит его для вас. В Windows используйте C:\path\to\capital-mcp\venv\Scripts\python.exe.

Claude Desktop

💡 Совет: Если вы установили через пакет MCPB (Вариант A выше), пропустите этот раздел — Claude Desktop записывает конфигурацию за вас на основе manifest.json. Используйте этот раздел только для ручной установки через скрипт.

macOS/Linux

Расположение конфигурации: ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) или ~/.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": ""
      }
    }
  }
}

Перезапустите Claude Desktop. Проверьте, набрав: "Какие инструменты Capital.com доступны?"

Windows

Расположение конфигурации: %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": ""
      }
    }
  }
}

Перезапустите Claude Desktop.

Claude Code

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

Cursor IDE

Откройте Настройки (Cmd+, / Ctrl+,) > Расширения > MCP > Настроить. Добавьте:

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

Перезапустите Cursor.

Codex

Настройки > MCP Servers > Добавить сервер. Используйте ту же команду, аргументы и переменные окружения, что и выше.

Windsurf

Создайте/отредактируйте ~/.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"
      }
    }
  }
}

Перезапустите Windsurf.

Пользовательские MCP-клиенты

Подойдет любой MCP-клиент, способный работать через STDIO. Пример с 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

Примеры использования

Пример разговора с 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

Рабочий процесс исполнения сделки (когда торговля включена)

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"

Справочник переменных окружения

Обязательные

• CAP_ENV - Окружение: demo или live (по умолчанию: demo)
• CAP_API_KEY - Ключ API от Capital.com
• CAP_IDENTIFIER - Email для входа
• CAP_API_PASSWORD - Пользовательский пароль ключа API

Контроль рисков (рекомендуется)

• CAP_ALLOW_TRADING - Включить торговлю (по умолчанию: false)
• CAP_ALLOWED_EPICS - Белый список через запятую (например, "SILVER,GOLD,BTCUSD") или "ALL" без ограничений
• CAP_MAX_POSITION_SIZE - Максимальный размер позиции (по умолчанию: 1.0)
• CAP_MAX_WORKING_ORDER_SIZE - Максимальный размер ордера (по умолчанию: 1.0)
• CAP_MAX_OPEN_POSITIONS - Максимум одновременных позиций (по умолчанию: 3)
• CAP_MAX_ORDERS_PER_DAY - Дневной лимит ордеров (по умолчанию: 20)
• CAP_REQUIRE_EXPLICIT_CONFIRM - Требовать confirm=true (по умолчанию: true)
• CAP_DRY_RUN - Блокировать все исполнения сделок (по умолчанию: false)

Необязательные

• CAP_DEFAULT_ACCOUNT_ID - Счет по умолчанию после входа
• CAP_HTTP_TIMEOUT_S - Тайм-аут HTTP (по умолчанию: 15)
• CAP_LOG_LEVEL - Уровень журнала: DEBUG, INFO, WARNING, ERROR (по умолчанию: INFO)

Инструменты MCP (реализовано 36)

Сессия (4)

• cap_session_status - Получить информацию о сессии
• cap_session_login - Создать сессию
• cap_session_ping - Поддержание активности
• cap_session_logout - Завершить сессию

Рыночные данные (6)

• cap_market_search - Поиск рынков
• cap_market_get - Получить детали рынка
• cap_market_prices - Исторические цены
• cap_market_sentiment - Настроения клиентов
• cap_market_navigation_root - Корень категорий рынков
• cap_market_navigation_node - Узел категорий рынков

Счет (6)

• cap_account_list - Список счетов
• cap_account_preferences_get - Получить настройки
• cap_account_preferences_set - Установить настройки
• cap_account_history_activity - История активности
• cap_account_history_transactions - История транзакций
• cap_account_demo_topup - Пополнить демо-счет

Торговля (11)

• Только чтение:

  • cap_trade_positions_list - Список позиций
  • cap_trade_positions_get - Получить детали позиции
  • cap_trade_orders_list - Список рабочих ордеров
  • cap_trade_confirm_get - Получить статус подтверждения
  • cap_trade_confirm_wait - Ожидать подтверждения

• Предпросмотр:

  • cap_trade_preview_position - Предпросмотр позиции
  • cap_trade_preview_working_order - Предпросмотр ордера

• Исполнение:

  • cap_trade_execute_position - Исполнить позицию
  • cap_trade_execute_working_order - Исполнить ордер
  • cap_trade_positions_close - Закрыть позицию
  • cap_trade_orders_cancel - Отменить ордер

Списки наблюдения (6)

• cap_watchlists_list - Список списков наблюдения
• cap_watchlists_create - Создать список наблюдения
• cap_watchlists_get - Получить список наблюдения
• cap_watchlists_add_market - Добавить рынок
• cap_watchlists_delete - Удалить список наблюдения
• cap_watchlists_remove_market - Удалить рынок

Потоковая передача (3)

• cap_stream_prices - Поток цен в реальном времени (WebSocket)
• cap_stream_alerts - Поток оповещений об уровнях цен (WebSocket)
• cap_stream_portfolio - Поток P&L портфеля в реальном времени (WebSocket)

MCP Prompts (Шаблоны рабочих процессов)

MCP prompts — это структурированные рабочие процессы, которые направляют Claude через сложные многоэтапные торговые операции. Они предоставляют пошаговые инструкции и лучшие практики для общих задач.

Доступные Prompts (7)

1. market_scan - Рабочий процесс анализа рынка

Проводит вас через сканирование списка наблюдения на предмет торговых условий.

Параметры:

• watchlist_id - Список наблюдения для сканирования (оставьте пустым, чтобы сначала вывести списки)
• timeframe - Разрешение цены: MINUTE, MINUTE_5, HOUR, DAY (по умолчанию: HOUR)
• lookback_periods - Количество свечей для получения: 1-1000 (по умолчанию: 24)

Рабочий процесс:

1. Получить рынки списка наблюдения
2. Получить данные о ценах для каждого рынка
3. Технический анализ (тренды, поддержка/сопротивление, паттерны)
4. Опциональная проверка настроений
5. Создать сводку возможностей

Пример использования:

• "Используй промпт market_scan для анализа моего списка наблюдения"
• "Просканируй мои рынки на предмет торговых сетапов"

Реальная торговля: Измените ваши конфигурации на: CAP_ENV: 'live', CAP_ALLOW_TRADING: 'true'

2. trade_proposal - Рабочий процесс планирования сделки

Проводит вас через создание торгового предложения с инструментами управления рисками.

Параметры:

• epic - Рынок для торговли (обязательно, например, SILVER, GOLD)
• direction - BUY или SELL (по умолчанию: BUY)
• thesis - Ваше торговое обоснование (необязательно)
• risk_percent - Риск в % от баланса (по умолчанию: 1.0%)

Рабочий процесс:

1. Получить детали рынка и правила заключения сделок
2. Рассчитать размер позиции на основе % риска
3. Определить уровни стоп-лосса и тейк-профита
4. Предпросмотр сделки (только проверка — без исполнения)
5. Вернуть preview_id для потенциального исполнения

Пример использования:

• "Создай торговое предложение для SILVER"
• "Предложи длинную сделку по GOLD с риском 2%"

Примечание: Этот промпт НЕ исполняет сделки — он только создает предпросмотры.

3. execute_trade - Рабочий процесс исполнения сделки

Проводит вас через исполнение предварительно просмотренной сделки.

Параметры:

• preview_id - Идентификатор предпросмотра из trade_proposal (обязательно)

Рабочий процесс:

1. Проверить, что preview_id предоставлен и действителен
2. Повторно проверить все средства контроля рисков
3. Исполнить позицию у брокера
4. Опросить подтверждение (ACCEPTED/REJECTED)
5. Сообщить окончательный статус

Пример использования:

• "Исполни сделку, которую я только что просмотрел"
• "Размести сделку с идентификатором предпросмотра abc-123"

Примечание:

• Требуется CAP_ALLOW_TRADING=true
• Требуется epic в белом списке
• Предпросмотр не должен быть просрочен (TTL 2 минуты)
• ⚠️ Это РАЗМЕСТИТ реальную сделку

4. position_review - Рабочий процесс анализа портфеля

Проводит вас через анализ ваших открытых позиций и ордеров.

Параметры: Отсутствуют (анализирует все текущие позиции)

Рабочий процесс:

1. Получить все открытые позиции
2. Получить все рабочие ордера
3. Рассчитать P&L, риск и показатели подверженности
4. Выявить риски концентрации и корреляции
5. Предложить потенциальные корректировки (без исполнения)

Пример использования:

• "Проверь мои текущие позиции"
• "Проанализируй подверженность моего портфеля"

Примечание: Это рабочий процесс только для чтения — сделки не исполняются.

5. live_price_monitor - Отслеживание цен в реальном времени (WebSocket)

Мониторинг рыночных цен в реальном времени с мгновенными оповещениями при движении цены за пределы порога.

Параметры:

• epics - Список EPIC рынков для мониторинга (оставьте пустым для поиска/выбора, макс. 40)
• duration_minutes - Как долго мониторить (по умолчанию: 5 минут, макс: 10 минут)
• threshold_percent - Оповещать при движении цены > этого % (по умолчанию: 1.0%)

Рабочий процесс:

1. Выбрать рынки для мониторинга (или указать EPIC напрямую)
2. Получить начальные цены для установления базового уровня
3. Подписаться на обновления цен WebSocket в реальном времени
4. Отображать табло цен в реальном времени с непрерывными обновлениями
5. Оповещать, когда любой рынок движется > threshold_percent
6. Автоматически остановить через duration_minutes

Пример использования:

• "Мониторь цены GOLD и SILVER в течение 2 минут"
• "Следи за BTC следующие 5 минут, оповещай о движениях в 2%" Примечание: Требуется CAP_WS_ENABLED=true. Сессии Capital.com WebSocket длятся не более 10 минут.

6. real_time_alerts — Условные ценовые оповещения (WebSocket)

Устанавливайте оповещения об уровнях цен и получайте мгновенные уведомления, когда рынки достигают ваших целей.

Параметры:

• alert_config — Уровни оповещений для каждого EPIC (например, {"GOLD": 2050.0, "SILVER": 28.5})
• duration_minutes — Максимальная продолжительность мониторинга (по умолчанию: 5 минут)
• auto_stop — Остановить мониторинг после первого оповещения? (по умолчанию: true)

Рабочий процесс:

1. Настройте условия оповещений (ценовые уровни для каждого рынка)
2. Подпишитесь на обновления цен через WebSocket
3. Непрерывно отслеживайте срабатывание оповещений
4. Отправляйте мгновенное оповещение при выполнении условия
5. При необходимости продолжайте мониторинг или остановитесь после первого оповещения

Примеры использования:

• «Оповести меня, когда GOLD достигнет 2050»
• «Уведоми, когда SILVER упадет ниже 28»

Примечание: Требуется CAP_WS_ENABLED=true.

7. live_portfolio_monitor — Отслеживание прибыли/убытка в реальном времени (WebSocket)

Наблюдайте за обновлением прибыли/убытка вашего портфеля в реальном времени по мере движения рыночных цен.

Параметры:

• duration_minutes — Продолжительность мониторинга (по умолчанию: 5 минут, макс.: 10 минут)
• alert_pnl_threshold — Оповещать, когда общая прибыль/убыток превысит эту сумму (по умолчанию: $100)

Рабочий процесс:

1. Получите текущие открытые позиции
2. Подпишитесь на обновления цен для рынков с позициями
3. Рассчитывайте прибыль/убыток в реальном времени по мере изменения цен
4. Отображайте панель портфеля в реальном времени
5. Оповещайте, когда прибыль/убыток пересечет пороговое значение

Примеры использования:

• «Отслеживай прибыль/убыток моего портфеля в течение 5 минут»
• «Наблюдай за позициями в реальном времени, оповести при прибыли/убытке в $500»

Примечание: Требуется CAP_WS_ENABLED=true и наличие активных позиций.

Как использовать подсказки

В Claude Desktop или других MCP-клиентах подсказки отображаются как доступные шаблоны взаимодействия. Вы можете вызывать их естественным образом в разговоре:

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]

Подсказки предоставляют структурированное руководство, сохраняя торговый контроль на протяжении всего рабочего процесса.

Ресурсы MCP (данные только для чтения)

Ресурсы MCP предоставляют доступ только для чтения к состоянию и конфигурации сервера через ресурсы на основе URI. В отличие от инструментов (которые выполняют действия), ресурсы предоставляют данные, которые клиенты могут читать и отслеживать.

Доступные ресурсы

1. cap://status — Статус сервера

Информация о сервере и сессии в реальном времени.

Возвращает: JSON с состоянием сервера, состоянием сессии, статусом аутентификации, ограничениями скорости

Пример:

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

Варианты использования: Мониторинг состояния сервера, проверка статуса сессии, отладка проблем аутентификации

---

2. cap://risk-policy — Политика рисков

Комплексная конфигурация управления рисками и торгового контроля.

Возвращает: JSON со всеми уровнями валидации, функциями торгового контроля и торговыми ограничениями

Пример:

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

Варианты использования: Понимание активных торговых контролей, аудит конфигурации рисков, документация по соблюдению требований

---

3. cap://allowed-epics — Торговый список разрешенных инструментов

Текущая конфигурация торгового списка разрешенных инструментов, показывающая разрешенные рынки.

Возвращает: JSON с режимом списка разрешенных, разрешенными EPIC и инструкциями по настройке

Пример:

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

Варианты использования: Проверка доступных для торговли рынков, верификация конфигурации списка разрешенных

---

4. cap://market-cache/{epic} — Детали рынка (динамические)

Кэшированные детали рынка для конкретного EPIC (получение в реальном времени от брокера).

Параметры:

• epic — Идентификатор рынка (например, «GOLD», «SILVER», «CS.D.EURUSD.TODAY.IP»)

Возвращает: JSON с исчерпывающей информацией о рынке

Аутентификация: Требуется

Пример: 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"
}

Варианты использования: Получение деталей рынка, проверка торговых правил, анализ маржинальных требований

---

Как использовать ресурсы

В Claude Desktop или других MCP-клиентах доступ к ресурсам можно получить по 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]

Ресурсы предоставляют удобный способ проверки состояния и конфигурации сервера без запуска инструментов. Для данных списка наблюдения используйте инструменты cap_watchlists_list и cap_watchlists_get.

Процесс исполнения сделок

Обязательное двухэтапное исполнение

Все операции с побочными эффектами используют строгий процесс предпросмотр → исполнение:

1. Предпросмотр: Проверка сделки на соответствие правилам брокера + локальной политике рисков

   • Возвращает preview_id с нормализованным запросом + проверками рисков
   • Без побочных эффектов, только валидация для чтения

2. Исполнение: Отправка сделки с использованием preview_id

   • Повторно выполняет критические проверки
   • Требуется confirm=true, если CAP_REQUIRE_EXPLICIT_CONFIRM=true
   • Ожидает подтверждения брокера
   • Увеличивает дневной счетчик ордеров

Контроль рисков

• Список разрешенных: Только EPIC из CAP_ALLOWED_EPICS могут торговаться
• Ограничения размера: Применяется максимальный размер позиции/ордера
• Ограничения позиций: Максимальное количество открытых позиций одновременно
• Дневные лимиты: Максимальное количество ордеров в день
• Нормализация размера: Округление до минимального/максимального/шага брокера
• Режим Dry-Run: Блокирует все исполнения, когда включен

Документация

• Руководство пользователя: USAGE.md — Подробное руководство с примерами
• Справочник Capital.com API: https://open-api.capital.com/
• Коллекция Postman Capital.com API: https://github.com/capital-com-sv/capital-api-postman

Лицензия

MIT

Отказ от ответственности — Использование Capital.com Public API со сторонними инструментами

Сторонняя интеграция

На этой странице описывается, как клиенты могут подключать Capital.com Public API к стороннему программному обеспечению, инструментам или интеграциям, включая те, которые работают на основе искусственного интеллекта или больших языковых моделей («LLM»). Любое такое стороннее программное обеспечение, инструмент или интеграция независимы от Capital.com и не являются частью услуг Capital.com. Capital.com не контролирует, не разрабатывает, не одобряет и не несет ответственности за любое стороннее программное обеспечение, его функциональность, результаты или любые последствия, возникающие в результате его использования. Любое использование сторонних инструментов или интеграций в связи с Capital.com Public API осуществляется исключительно на ваш собственный риск. Вы несете ответственность за ознакомление с условиями, политиками конфиденциальности и практиками обработки данных любого стороннего инструмента, который вы решите использовать.

Использование Public API

Использование вами Capital.com Public API осуществляется исключительно по вашему усмотрению и на ваш риск. Capital.com предоставляет Public API в информационных и торговых целях, но не рекомендует, не одобряет и не поощряет какое-либо конкретное использование, интеграцию или торговую стратегию. Вы несете единоличную ответственность за то, как вы получаете доступ и используете API, включая параметры любых отправляемых ордеров, конфигурацию любых подключенных инструментов или систем, а также интерпретацию любых полученных данных. Capital.com не несет ответственности за убытки или непредвиденные результаты, возникающие в результате использования вами API, будь то прямой доступ или через сторонние инструменты. Доступность, функциональность и спецификации API могут быть изменены, ограничены по скорости, приостановлены или прекращены в любое время без предварительного уведомления. Использование вами Public API регулируется Условиями и положениями Capital.com и Условиями электронной торговли, с которыми вам следует внимательно ознакомиться перед использованием API.

Услуги только по исполнению и отсутствие инвестиционных советов Capital.com предоставляет свои услуги исключительно на основе исполнения. Торговля финансовыми инструментами сопряжена со значительным риском убытков. Ничто на этой странице, в Public API или в любом стороннем программном обеспечении или интеграции не является инвестиционной консультацией, персональной рекомендацией или предложением купить или продать какой-либо финансовый инструмент. Это включает любые результаты, сигналы, предложения или анализ, сгенерированные ИИ, инструментами на основе LLM или другими автоматизированными средствами. Все торговые решения, включая любую автоматизированную или алгоритмическую деятельность, принимаются на ваш собственный риск и остаются вашей исключительной ответственностью. Риски автоматизированной и алгоритмической торговли Использование Public API в связи с автоматизированными или алгоритмическими торговыми инструментами несет дополнительные риски, включая, помимо прочего: быстрое исполнение ордеров без проверки или вмешательства человека; системные ошибки, сбои программного обеспечения или проблемы с подключением; исполнение по ценам, существенно отличающимся от ожидаемых; а также непреднамеренные или ошибочные ордера, возникающие в результате неправильно настроенных инструментов или параметров. Capital.com не несет ответственности за любые убытки, возникающие в результате таких рисков или взаимодействия между его системами и любыми сторонними инструментами. Прошлые результаты и любые результаты, сгенерированные автоматизированными инструментами, не являются показателем будущих результатов.

Запрещенное использование

Использование Public API и любых подключенных инструментов не должно использоваться для манипулирования платформой Capital.com, использования ценообразования или задержек, участия в рыночных злоупотреблениях или получения какого-либо несправедливого преимущества. Capital.com оставляет за собой право ограничить, приостановить или прекратить доступ к API и/или вашу учетную запись, если у нее есть разумные основания полагать, что такое неправомерное использование произошло или может произойти. Клиенты не должны позволять какой-либо третьей стороне осуществлять дискреционный контроль над своей учетной записью.

Ваши обязанности

Вы несете ответственность за обеспечение того, чтобы использование вами платформы Capital.com, Public API и любых сторонних инструментов или интеграций соответствовало Условиям и положениям Capital.com, Условиям электронной торговли и всем применимым законам и нормативным актам в вашей юрисдикции. Вам следует тщательно обдумать, подходят ли автоматизированные торговые инструменты для ваших обстоятельств, опыта и толерантности к риску, прежде чем использовать их. Capital.com настоятельно рекомендует тщательно протестировать любые автоматизированные инструменты или интеграции с использованием Демо-счета, прежде чем подключать их к реальной торговой среде.