SnapEX Pay

официальный

Криптовалютные платежи для ИИ-агентов: самостоятельное управление аккаунтом, счета, приём платежей, выплаты, обмен.

Что можно делать с SnapEX Pay MCP?

Откройте аккаунт мерчанта — Попросите агента вызвать create_account, чтобы получить api_key, login/password для кабинета и mcp_personal_url без капчи и электронной почты.
Создавайте счета и отслеживайте их — Используйте create_invoice, чтобы получить pay_url для плательщика, затем опрашивайте get_invoice, пока статус не станет paid; тестовый режим работает без реальных денег.
Безопасно отправляйте криптовалютные выплаты — Получите котировку с помощью preview_payout, затем вызовите create_payout, указав preview_id и idempotency_key, чтобы повторные попытки не приводили к двойной выплате.
Проверяйте каталог и комиссии — Запросите list_assets, get_fiat_rates, get_fees и list_static_address_networks до того, как понадобится какой-либо ключ.
Конвертируйте активы на балансе — Получите котировку с помощью preview_conversion и выполните конвертацию через create_conversion, чтобы обменять другие активы на баланс в USDT.

Размещённый MCP-сервер

npx add-mcp 'https://pay.snapex.pro/mcp'

Устанавливается в Claude Code, Codex, Cursor и другие

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

MCP-сервер SnapEX Pay

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

MCP-сервер SnapEX Pay позволяет ИИ-агенту работать с криптовалютными платежами без участия человека. Агент подключается к https://pay.snapex.pro/mcp,, самостоятельно открывает аккаунт продавца SnapEX Pay (без капчи и электронной почты) и получает API-ключ. Затем он может создавать счета с размещёнными страницами оплаты, получать криптовалюту на постоянные адреса для депозитов, хранить баланс в USDT, отправлять выплаты в разных монетах и сетях, а также управлять вебхуками. Тестовый режим позволяет пройти весь процесс без реальных денег. Перед выплатой всегда выполняется бесплатный предварительный просмотр, а для неё используется ключ идемпотентности, поэтому повторный запрос не приведёт к двойной выплате. Удалённый сервер (Streamable HTTP) или локальный пакет: npx -y snapex-pay-mcp.

Удалённый сервер (рекомендуется, ничего устанавливать не нужно): https://pay.snapex.pro/mcp — Streamable HTTP.
Локальный пакет stdio: npx -y snapex-pay-mcp — те же инструменты, тонкий клиент того же API.
Docker: docker build -t snapex-pay-mcp . && docker run -i --rm snapex-pay-mcp.
Имя в MCP Registry: pro.snapex/pay.
Документация для пользователей: https://pay.snapex.pro/mcp · справочник REST API: https://pay.snapex.pro/partner/merchant/docs · карточка сервера: https://pay.snapex.pro/.well-known/mcp.json · https://pay.snapex.pro/llms.txt
Политика конфиденциальности: https://pay.snapex.pro/privacy · Условия использования: https://pay.snapex.pro/terms · Правила для продавцов: https://pay.snapex.pro/rules · Поддержка: https://pay.snapex.pro/#chat

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

Подключитесь без ключа. Инструменты каталога (list_assets, get_fiat_rates, get_fees, list_static_address_networks) доступны сразу.
Вызовите create_account. Он возвращает api_key (отображается один раз), данные для входа в кабинет login/password для человека и mcp_personal_url. Новый ключ сразу же используется: на удалённом сервере — до конца сеанса MCP, в пакете stdio — до завершения процесса (и сохраняется в ~/.config/snapex-pay/credentials.json для следующих запусков).
Получение платежей: create_invoice → передайте плательщику pay_url → вызывайте get_invoice, пока не получите paid. environment: "test" позволяет пройти весь процесс без реальных денег (тестовый счёт становится оплаченным примерно через 10 секунд после выбора монеты; баланс не меняется).
Отправка: preview_payout (бесплатная оценка) → create_payout с preview_id и собственным idempotency_key (операция необратима; повторный запрос с тем же ключом не приведёт к двойной выплате).
Баланс хранится в USDT: чтобы получить другую монету, отправьте выплату в этой монете. preview_conversion → create_conversion конвертирует другие активы, которые всё ещё хранятся на старом аккаунте.

В каждом сообщении об ошибке указано, что делать дальше (what_to_do), например: unauthorized → вызовите create_account; rate_limited → подождите retry_after_seconds.

Подключение

Claude Code

claude mcp add --transport http snapex-pay https://pay.snapex.pro/mcp
# with an existing key:
claude mcp add --transport http snapex-pay https://pay.snapex.pro/mcp --header "Authorization: Bearer smk_…"

Cursor — `~/.cursor/mcp.json`

{
  "mcpServers": {
    "snapex-pay": { "url": "https://pay.snapex.pro/mcp" }
  }
}

Добавьте "headers": { "Authorization": "Bearer smk_…" }, чтобы использовать один аккаунт в разных сеансах.

VS Code — `.vscode/mcp.json`

{
  "servers": {
    "snapex-pay": { "type": "http", "url": "https://pay.snapex.pro/mcp" }
  }
}

Windsurf — `~/.codeium/windsurf/mcp_config.json`

{
  "mcpServers": {
    "snapex-pay": { "serverUrl": "https://pay.snapex.pro/mcp" }
  }
}

Cline — `cline_mcp_settings.json`

{
  "mcpServers": {
    "snapex-pay": { "type": "streamableHttp", "url": "https://pay.snapex.pro/mcp" }
  }
}

Пошаговые инструкции для установщиков на базе ИИ: llms-install.md.

Gemini CLI

В качестве расширения (в этом репозитории есть gemini-extension.json):

gemini extensions install https://github.com/snapexpay/snapex-pay-mcp

или в ~/.gemini/settings.json:

{
  "mcpServers": {
    "snapex-pay": { "httpUrl": "https://pay.snapex.pro/mcp" }
  }
}

Claude Desktop — `claude_desktop_config.json`

Удалённый сервер через mcp-remote:

{
  "mcpServers": {
    "snapex-pay": { "command": "npx", "args": ["-y", "mcp-remote", "https://pay.snapex.pro/mcp"] }
  }
}

или локальный пакет:

{
  "mcpServers": {
    "snapex-pay": {
      "command": "npx",
      "args": ["-y", "snapex-pay-mcp"],
      "env": { "SNAPEX_API_KEY": "smk_…" }
    }
  }
}

(SNAPEX_API_KEY необязателен: без него агент вызывает create_account, а ключ сохраняется для следующих запусков.)

Подключения claude.ai и ChatGPT

Добавьте пользовательское подключение с URL https://pay.snapex.pro/mcp без аутентификации. Эти клиенты не могут отправлять заголовки, поэтому после вызова create_account возьмите mcp_personal_url из ответа (он также возвращается через get_account) и используйте его как URL подключения — тогда каждый новый чат будет работать с тем же аккаунтом. Этот URL содержит учётные данные: храните его как пароль.

OpenAI Responses API

{
  "type": "mcp",
  "server_label": "snapex_pay",
  "server_url": "https://pay.snapex.pro/mcp",
  "headers": { "Authorization": "Bearer smk_…" },
  "require_approval": { "always": { "tool_names": ["create_payout", "create_conversion"] } }
}

Другие клиенты и каталоги

В репозитории находятся манифесты, которые используют каталоги: server.json (официальный MCP Registry), glama.json (Glama), gemini-extension.json + GEMINI.md (Gemini CLI), lhm.plugin.json (LobeHub), .cursor-plugin/plugin.json + mcp.json (Cursor Marketplace), plugin.json (Agent Plugins / Kiro), llms-install.md (Cline).

Docker

docker build -t snapex-pay-mcp .
docker run -i --rm -e SNAPEX_API_KEY=smk_… snapex-pay-mcp

Инструменты

Аккаунт

Инструмент	Назначение
`create_account`	Открыть аккаунт SnapEX Pay (без капчи)
`get_account`	Показать текущий аккаунт и ключ

Каталог (ключ не нужен)

Инструмент	Назначение
`list_assets`	Список монет и сетей
`get_fiat_rates`	Курсы обмена фиатных валют
`get_fees`	Текущие оценки комиссий для маршрутов
`list_static_address_networks`	Сети для постоянных адресов

Баланс

Инструмент	Назначение
`get_balances`	Баланс аккаунта
`list_transactions`	История баланса

Получение платежей

Инструмент	Назначение
`create_invoice`	Создать счёт (получить криптовалюту)
`get_invoice`	Статус счёта
`list_invoices`	Список счетов
`get_invoice_payment_methods`	Монеты, которыми можно оплатить счёт
`select_invoice_payment_method`	Выбрать монету для счёта
`preview_payment`	Рассчитать стоимость прямого платежа
`create_payment`	Создать прямой платёж
`get_payment`	Статус платежа
`list_payments`	Список платежей
`create_static_address`	Постоянный адрес для депозита
`list_static_addresses`	Список постоянных адресов
`list_static_address_deposits`	Депозиты на постоянный адрес

Отправка (выплаты)

Инструмент	Назначение
`preview_payout`	Рассчитать стоимость выплаты (отправить криптовалюту)
`create_payout`	Отправить выплату (необратимо) ⚠️ необратимо
`get_payout`	Статус выплаты
`list_payouts`	Список выплат

Обмен

Инструмент	Назначение
`preview_conversion`	Рассчитать стоимость конвертации (обмена)
`create_conversion`	Выполнить конвертацию ⚠️ необратимо
`get_conversion`	Статус конвертации
`list_conversions`	Список конвертаций

Вебхуки

Инструмент	Назначение
`list_webhooks`	Список конечных точек вебхуков
`create_webhook`	Добавить конечную точку вебхука
`update_webhook`	Изменить конечную точку вебхука
`rotate_webhook_secret`	Создать новый секрет вебхука ⚠️ необратимо

Ресурсы: snapex://docs/quickstart, snapex://docs/webhooks. Подсказки: accept_crypto_payment, send_crypto_payout.

Переменные окружения (пакет stdio)

Переменная	Значение по умолчанию	Назначение
`SNAPEX_API_KEY`	—	API-ключ продавца `smk_…`. Необязательно: `create_account` создаёт его.
`SNAPEX_BASE_URL`	`https://pay.snapex.pro`	Базовый URL API.
`SNAPEX_CREDENTIALS_FILE`	`~/.config/snapex-pay/credentials.json`	Путь для сохранения ключа из `create_account` (права доступа 600).
`SNAPEX_NO_SAVE`	—	`1` — не сохранять учётные данные на диск.

Безопасность

Агент распоряжается только средствами собственного аккаунта; новый аккаунт начинается с нулевого баланса.
Ключ и сгенерированный пароль отображаются один раз. Человек может войти в кабинет с логином и паролем и отозвать или заменить там ключи.
Выплаты выполняются в два этапа (расчёт, затем отправка) и требуют idempotency_key; create_payout, create_conversion и rotate_webhook_secret помечены как destructiveHint, поэтому клиенты могут запросить подтверждение перед их выполнением.
Ограничения: несколько новых аккаунтов с одного IP-адреса в час; около 120 вызовов API в минуту на ключ; 5 выплат в минуту и 30 в час.
Правила о том, что разрешено продавать: https://pay.snapex.pro/rules.

Разработка

Список инструментов генерируется на основе сервера SnapEX Pay (app/Mcp/McpToolCatalog.php):

php artisan mcp:export-tools      # writes src/tools.json, syncs the version of the manifests and LobeHub's tools
npm ci && npm test                # build + offline smoke test with the official MCP SDK client
SNAPEX_E2E_BASE_URL=http://127.0.0.1:8765 node test/smoke.mjs   # full flow against a local (never production) server

Поддержка

Чат: https://pay.snapex.pro/#chat · Конфиденциальность: https://pay.snapex.pro/privacy · Условия использования: https://pay.snapex.pro/terms

Лицензия

MIT