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 работает только на условиях исполнения (execution-only) и не поддерживает и не несёт ответственности за стороннее программное обеспечение или его результаты. Ничто здесь не является инвестиционной рекомендацией. Вы несёте полную ответственность за свои торговые решения, включая любые ценовые расхождения, возникающие из-за задержек, вносимых сторонними инструментами, и обязаны соблюдать применимые условия и законы.

Крипто-деривативы недоступны розничным клиентам, зарегистрированным в 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

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

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 (отметьте «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

Вариант 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 - Включить торговлю (по умолчанию: 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

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 могут торговаться
• Лимиты размера: Максимальный размер позиции/ордера
• Лимиты позиций: Максимальное количество открытых позиций в любой момент времени
• Дневные лимиты: Максимальное количество ордеров в день
• Нормализация размера: Округление до минимального/максимального/шага брокера
• Режим сухого прогона: Блокирует все исполнения при включении

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

• Руководство по использованию: USAGE.md - Полное руководство по использованию с примерами
• Справочник Capital.com API: https://open-api.capital.com/
• Коллекция Postman для Capital.com API: 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 предоставляет свои услуги только на условиях исполнения (execution-only). Торговля финансовыми инструментами сопряжена со значительным риском потерь. Ничто на этой странице, в 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 настоятельно рекомендует вам тщательно протестировать любые автоматизированные инструменты или интеграции с помощью демо-счета, прежде чем подключать их к реальной торговой среде.