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 (UK) Ltd.

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

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

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

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

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

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

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

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

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

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

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

Установка с помощью ИИ: Откройте папку этого проекта в редакторе с поддержкой ИИ (Claude Code, Cursor, Windsurf) и попросите установить MCP-сервер Capital.com — он будет следовать INSTALL.md, чтобы провести вас через настройку, выбрав лучший метод для вашей среды.

У вас также есть следующие варианты ручной установки:

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

Репозиторий включает предварительно собранный пакет capital-mcp.mcpb — откройте его в Claude Desktop, и все готово, ручное редактирование конфигурации не требуется.

Шаги:

1. Клонируйте репозиторий:

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

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

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

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

• macOS: brew install python3 git
• Ubuntu/Debian: sudo apt install python3 python3-venv git
• Windows: python.org (отметьте «Добавить в 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
CAP_ALLOW_TRADING=true
CAP_ALLOWED_EPICS=ALL

# Optional: enable later for real trading
# CAP_ALLOW_TRADING=true
# Narrow the allowlist to the instruments you actually trade
# CAP_ALLOWED_EPICS=SILVER,GOLD,BTCUSD

Вариант C: Docker

Предварительные требования: Docker должен быть установлен.

1. Создайте файл .env с вашими учетными данными (см. .env.example):

   CAP_ENV=demo
   CAP_API_KEY=your_api_key_here
   CAP_IDENTIFIER=your_email@example.com
   CAP_API_PASSWORD=your_custom_password
   CAP_ALLOW_TRADING=false
   

2. Запустите сервер:

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

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

Если у вас возникли проблемы при использовании 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

---

Интеграция с клиентами

Для конфигурации, специфичной для клиента (Claude Desktop, Claude Code, Cursor, Windsurf, Codex, Docker, пользовательские клиенты), см. USAGE.md — Интеграция с клиентами.

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

Пример разговора с 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 - Электронная почта для входа
• CAP_API_PASSWORD - Собственный пароль ключа API

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

• CAP_ALLOW_TRADING - Включить торговлю (по умолчанию: true)
• CAP_ALLOWED_EPICS - Инструменты, для которых разрешена торговля (по умолчанию: ALL, все инструменты). Ограничьте списком через запятую, например «SILVER,GOLD,BTCUSD». Пустое значение блокирует всю торговлю
• 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

38 инструментов в 6 категориях, 7 рабочих процессов-подсказок и 4 ресурса только для чтения.

Категория	Инструменты	Описание
Сессия	4	Вход, выход, статус, поддержание активности
Рыночные данные	6	Поиск, детали, цены, настроения, навигация
Аккаунт	6	Список аккаунтов, настройки, история активности/транзакций, пополнение демо
Торговля	13	Предпросмотр, исполнение, закрытие позиций; список/отмена/изменение рабочих ордеров; подтверждения
Списки наблюдения	6	Создание, список, получение, удаление списков наблюдения; добавление/удаление рынков
Стриминг	3	Цены в реальном времени, оповещения, P&L портфеля через WebSocket

Подсказка	Описание
market_scan	Сканирование списка наблюдения на предмет торговых условий
trade_proposal	Планирование сделки с расчетом размера на основе риска (только предпросмотр)
execute_trade	Исполнение ранее предпросмотренной сделки
position_review	Анализ открытых позиций и экспозиции (только чтение)
live_price_monitor	Отслеживание цен в реальном времени с оповещениями о движении (WebSocket)
real_time_alerts	Условные оповещения о ценовых уровнях (WebSocket)
live_portfolio_monitor	Живая панель P&L портфеля (WebSocket)

Ресурс	Описание
cap://status	Здоровье сервера, состояние сессии, лимиты запросов
cap://risk-policy	Конфигурация управления рисками и уровни валидации
cap://allowed-epics	Конфигурация белого списка торговли
cap://market-cache/{epic}	Кэшированные рыночные детали (живая загрузка)

Для полных деталей, параметров и примеров см. USAGE.md.

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

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

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

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

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

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

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

Средства контроля риска

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

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

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

Лицензия

MIT

Политика конфиденциальности

MCP-сервер Capital.com работает локально на вашем компьютере и связывается напрямую с Capital.com Public API, используя предоставленные вами учетные данные. Он не работает как размещенный сервис и не имеет собственных серверов.

Сбор данных

MCP-сервер не собирает и не хранит никаких данных. Он действует как локальный мост между вашим ИИ-клиентом и Capital.com Public API.

Использование и хранение данных

Все данные, которыми обмениваются во время сессии, обрабатываются в памяти на вашем локальном компьютере и удаляются после завершения сессии. MCP-сервер не записывает данные на диск. Примечание: ваш ИИ-клиент может обрабатывать, регистрировать или хранить данные, проходящие через него, в соответствии с его собственной политикой конфиденциальности, которую вам следует изучить отдельно.

Передача третьим лицам

MCP-сервер не передает данные третьим лицам. Данные передаются только между вашей локальной средой и Capital.com Public API, в соответствии с собственной Политикой конфиденциальности Capital.com.

Хранение данных

MCP-сервер не хранит никаких данных. Данные сессии существуют только в памяти в течение сессии.

Учетные данные API

Предоставленные вами учетные данные API хранятся и управляются в вашей локальной среде. Вы несете ответственность за их надлежащую защиту.

Контакт

По вопросам конфиденциальности, касающимся вашего аккаунта Capital.com или того, как Capital.com обрабатывает ваши данные, обращайтесь к Политике конфиденциальности Capital.com или свяжитесь с support@capital.com.

Отказ от ответственности — Использование 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-инструментами или другими автоматизированными средствами. Все торговые решения, включая любую автоматизированную или алгоритмическую деятельность, принимаются на ваш собственный риск и остаются вашей исключительной ответственностью. Capital.com не контролирует результаты работы сторонних ИИ или LLM-инструментов, подключенных к Public API, и не может гарантировать, что такие инструменты не будут генерировать контент, который может быть истолкован как инвестиционный совет или персональная рекомендация. Любые такие результаты не предоставляются Capital.com или от его имени и не должны рассматриваться как совет.

Риски автоматизированной и алгоритмической торговли

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

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

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

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

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

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