FxSocket

npx add-mcp 'https://mcp.fxsocket.com/mcp'

MCP-сервер MetaTrader

Дайте ИИ-агенту доступ на чтение к вашим счетам MetaTrader 4 и MetaTrader 5. MCP-сервер FxSocket позволяет Claude, Cursor, VS Code и любому другому клиенту Model Context Protocol отвечать на вопросы о вашей торговле: баланс и средства по всем счетам, что открыто прямо сейчас, как прошёл прошлый месяц, живые котировки и история цен. Он работает только на чтение. Ни один инструмент не может разместить, изменить или закрыть ордер.

URL сервера https://mcp.fxsocket.com/mcp

1. Создайте API-ключ только для чтения

На странице API-ключей создайте ключ только для чтения. Он начинается с fxs_ro_, может вызывать все инструменты отсюда и не может торговать ни через какую другую конечную точку. Дайте ему имя и ограничьте его счетами, которые должен видеть агент, — и агент никогда не узнает, что существуют остальные. Ваш полный ключ fxs_live_ тоже подойдёт, но агенту он ни к чему.

2. Подключите ваш клиент

Клиенты, которые принимают URL удалённого сервера и заголовок, подключаются напрямую. Клиенты, которые запускают только локальные серверы, например Claude Desktop, используют Docker-образ.

claude mcp add --transport http fxsocket https://mcp.fxsocket.com/mcp \
  --header "X-API-Key: fxs_ro_xxx"

{
  "mcpServers": {
    "fxsocket": {
      "url": "https://mcp.fxsocket.com/mcp",
      "headers": { "X-API-Key": "fxs_ro_xxx" }
    }
  }
}

{
  "servers": {
    "fxsocket": {
      "type": "http",
      "url": "https://mcp.fxsocket.com/mcp",
      "headers": { "X-API-Key": "fxs_ro_xxx" }
    }
  }
}

{
  "mcpServers": {
    "fxsocket": {
      "command": "docker",
      "args": ["run", "-i", "--rm", "-e", "FXSOCKET_API_KEY", "fxsocket/mcp"],
      "env": { "FXSOCKET_API_KEY": "fxs_ro_xxx" }
    }
  }
}

Любой другой клиент работает так же: укажите ему https://mcp.fxsocket.com/mcp с ключом в заголовке X-API-Key (Authorization: Bearer тоже принимается) или запустите Docker-образ как локальный сервер.

Инструменты

Восемь инструментов, все только для чтения. Каждый построен вокруг вопроса, а не вокруг конечной точки, поэтому «что открыто по всем моим счетам» — это один вызов, который читает все терминалы сразу.

• list_accounts: Каждый счёт, который видит ключ, с его id, псевдонимом, платформой, сервером, логином и статусом подключения, опционально с балансом, средствами и итогами по каждой валюте. Агенты вызывают его первым.
• get_account: Один счёт полностью: баланс, средства, маржа, уровень маржи и плечо, настройки счёта, такие как уровень стоп-аута, и состояние терминала.
• get_open_positions: Открытые позиции и отложенные ордера по всем счетам с фильтрацией по символу и типу, с плавающей прибылью, свопом и итогами по каждой валюте.
• get_trade_history: Закрытые сделки за период (по умолчанию последние 7 дней, до 366), с прибыльными, убыточными, процентом прибыльных, чистой прибылью, лучшей и худшей сделкой и разбивкой по символам.
• search_symbols: Точное имя символа у брокера. EURUSD у некоторых брокеров — это EURUSD.sd или EURUSDm, поэтому агенты сначала ищут его, прежде чем запрашивать цены.
• get_quotes: Живые bid, ask и спред для до 20 символов.
• get_symbol_info: Спецификация контракта: количество знаков, размер контракта, стоимость тика, ограничения объёма, ставки свопа, комиссии и торговые сессии.
• get_price_history: Свечи OHLC для символа и таймфрейма, до 500 баров за вызов.

Что можно спросить

• «Каковы мои суммарные средства по всем счетам, по каждой валюте?»
• «Какие открытые позиции сейчас в минусе и на сколько?»
• «Каким был мой процент прибыльных сделок по XAUUSD в прошлом месяце и какой была моя худшая сделка?»
• «Сравни спред EURUSD у каждого из моих брокеров.»
• «Выгрузи последние 200 свечей H1 по GBPUSD и опиши тренд.»

Только для чтения по своей архитектуре

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

Деньги указываются в валюте депозита каждого счёта и никогда не суммируются между валютами; инструменты возвращают итоги по каждой валюте, чтобы модели не приходилось выполнять эту арифметику. Время — серверное время брокера, как и везде в API.

Ограничения: 60 запросов в минуту на пользователя, до 50 счетов и 300 строк ордеров или сделок в одном ответе. Количество и итоги всегда охватывают всё; урезаются только списки строк.

Запуск локально с Docker

Образ fxsocket/mcp запускает сервер как локальный процесс stdio для клиентов, которые сами запускают свои серверы. Это небольшой ретранслятор — один файл Python без зависимостей, — который передаёт каждое сообщение в mcp.fxsocket.com с вашим ключом. Инструменты и ваши данные по-прежнему поступают из FxSocket, поэтому образ никогда не нужно обновлять при изменении инструментов. Опубликован для amd64 и arm64.

FXSOCKET_API_KEY=fxs_ro_xxx docker run -i --rm -e FXSOCKET_API_KEY fxsocket/mcp

Docker Hub · Исходный код на GitHub (MIT)

Детали протокола

• Транспорт: Streamable HTTP, только POST, ответы в JSON. Без сохранения состояния, без сессии, которую нужно поддерживать.
• Версии протокола: 2026-07-28 (метаданные в каждом запросе, без рукопожатия) и с 2025-03-26 по 2025-11-25 (рукопожатие initialize).
• Аутентификация: те же API-ключи, что и у API платформы, в X-API-Key или Authorization: Bearer.
• Пока не поддерживается: веб-коннекторы в claude.ai и ChatGPT, которые входят через OAuth, а не через заголовок. Claude Desktop уже работает через Docker-образ.