xRocket Exchange MCP

Готовьте, проверяйте и исполняйте ордера xRocket CEX через MCP-совместимый ИИ-клиент. Локальный сервер получает оценку биржи, комиссию, рыночные правила, соответствующие балансы и точное намерение до отдельно одобряемого исполнения.

Размещённый endpoint остаётся публичной демонстрацией рыночных данных и путём онбординга; он никогда не получает учётные данные аккаунта и не может совершать сделки. Этот пакет не аффилирован с xRocket и не одобрен xRocket. Настроить торговлю или открыть xRocket.

Быстрый старт торговли

1. Войдите в xRocket и откройте Меню → Настройки → Настройки биржи → API-токен.

2. Создайте тестнет-ориентированную MCP-конфигурацию только для ордеров:

npx -y xrocket-mcp@0.5.0 trading-config

3. Вставьте выведенный JSON в свой локальный MCP-клиент. Замените SET_YOUR_XROCKET_API_TOKEN_LOCALLY только в локальном секрете или настройках окружения клиента.

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

Используйте npx -y xrocket-mcp@0.5.0 trade-config --mainnet только после проверки на тестнете. Он включает отдельный шлюз ордеров для mainnet; переводы и выводы средств остаются отключёнными.

Токен вышестоящей системы имеет широкий доступ к аккаунту, а не документированные гранулярные области действия. Никогда не помещайте его в чат, на размещённый endpoint, в файл в коммите, в issue или в журнал.

Related MCP server: tossinvest-openapi-mcp

Хостинговая демонстрация рынка

Используйте страницу подключения или скопируйте публичный endpoint mainnet без установки чего-либо и без указания учётных данных:

https://xrocket-mcp-production.up.railway.app/mcp

Он открывает только 10 публичных инструментов и не может читать токены аккаунта или включать финансовые записи. При просьбе о торговле его онбординг-инструмент направляет пользователя к локальной настройке выше.

Локальный быстрый старт

npx -y xrocket-mcp@0.5.0 doctor
npx -y xrocket-mcp@0.5.0 config

Требуется Node.js 20 или новее. Публичное чтение рыночных данных работает без конфигурации:

XROCKET_PROFILE=public
XROCKET_ENVIRONMENT=mainnet

Установите комплексный плагин Codex из маркетплейса репозитория:

codex plugin marketplace add nakazanie-ton/myrocket --ref main
codex plugin add xrocket-exchange@xrocket-agents

Пример MCP-клиента:

{
  "mcpServers": {
    "xrocket": {
      "command": "npx",
      "args": ["-y", "xrocket-mcp@0.5.0"],
      "env": {
        "XROCKET_ENVIRONMENT": "mainnet",
        "XROCKET_ENABLE_TRADING": "false",
        "XROCKET_ENABLE_TRANSFERS": "false",
        "XROCKET_ENABLE_WITHDRAWALS": "false",
        "XROCKET_ALLOW_MAINNET_WRITES": "false"
      }
    }
  }
}

Для разработки из исходного кода выполните npm ci, npm test и npm run build в этом каталоге.

Профили и шлюзы записи

• public: 10 неаутентифицированных инструментов, включая составной xrocket_market_snapshot.

• private-read: публичные инструменты плюс балансы, обзор аккаунта, ордера, переводы, вывода и квоты; определяется автоматически при наличии XROCKET_API_TOKEN.

• full: все инструменты, но каждое семейство исполнения остаётся отключённым, пока его собственный шлюз не установлен в true.

Шлюзы записи — это XROCKET_ENABLE_TRADING, XROCKET_ENABLE_TRANSFERS и XROCKET_ENABLE_WITHDRAWALS; все по умолчанию равны false. Запись в mainnet также требует XROCKET_ALLOW_MAINNET_WRITES=true.

Каждая финансовая запись сохраняет точное подготовленное намерение в памяти сервера и возвращает кратковременную, привязанную к запросу одноразовую квитанцию на подтверждение. Недостающие идентификаторы клиента генерируются на этапе подготовки и показываются в предпросмотре. Исполнение принимает только эту квитанцию. Записи автоматически не повторяются после неоднозначного результата сети; сначала сверяйте по идентификатору клиента.

Квитанция связывает полезную нагрузку, но не подтверждает согласие человека. Если ваш MCP-клиент не имеет доверенного интерфейса одобрения или протокола одобрения вне канала, оставляйте все шлюзы исполнения отключёнными.

Границы

• API биржи не имеет endpoint адресов депозитов; онбординг — это только руководство по интерфейсу.

• Внутренние переводы биржи — это переводы между funding ↔ trading, а не платежи типа «пользователь-пользователь».

• xRocket Pay — отдельный продукт и не входит в комплект.

• WebSocket-каналы регулярно проверяются, но в 0.5.0 используются ограниченные REST-снимки данных.

• Храните финансовые значения в виде десятичных строк и используйте TONCOIN там, где этого требует текущий API.

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