Подключение
Адрес сервера (Streamable HTTP):
https://pay.snapex.pro/mcp
Ключ для начала не нужен: агент вызывает create_account и продолжает с новым ключом в той же сессии. Настройки для популярных клиентов:
Claude Code
claude mcp add --transport http snapex-pay https://pay.snapex.pro/mcp
Cursor — ~/.cursor/mcp.json
{
"mcpServers": {
"snapex-pay": {
"url": "https://pay.snapex.pro/mcp"
}
}
}
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"
}
}
}
Claude Desktop — claude_desktop_config.json
{
"mcpServers": {
"snapex-pay": {
"command": "npx",
"args": [
"-y",
"mcp-remote",
"https://pay.snapex.pro/mcp"
]
}
}
}
Коннекторы claude.ai и ChatGPT
Добавьте свой коннектор с адресом сервера. Эти клиенты не умеют передавать заголовки, поэтому после create_account возьмите из ответа mcp_personal_url и укажите его адресом коннектора — так в каждом новом чате будет тот же аккаунт. Храните этот адрес как пароль.
Если ключ уже есть
Добавьте заголовок Authorization: Bearer smk_… — ключ мерчанта из кабинета (Мерчант → Разработчикам) или из ответа create_account.
{
"mcpServers": {
"snapex-pay": {
"url": "https://pay.snapex.pro/mcp",
"headers": {
"Authorization": "Bearer smk_…"
}
}
}
}
Как с ним работает агент
- Подключите адрес — ключ не нужен.
- Агент вызывает
create_account: без капчи и без почты. Он получает ключ со всеми правами, и сессия продолжается с ним. - Принять оплату:
create_invoice→ плательщик открываетpay_url→get_invoiceпоказывает paid. Платежи зачисляются на баланс в USDT. - Выплатить:
preview_payoutпоказывает сумму и комиссию,create_payoutотправляет — в любой монете изlist_assets.
Инструменты
Одни и те же инструменты в удалённом сервере и в локальном пакете. Каждый ответ — JSON; ошибка подсказывает, что делать дальше.
Аккаунт
create_account, 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
Безопасность
- Ключ и сгенерированный пароль показываются один раз — в ответе
create_account. По логину и паролю человек может войти в кабинет. - Агент распоряжается только деньгами своего аккаунта. Новый аккаунт начинает с нуля; деньги приходят от оплат его счетов и адресов.
- Отправка — в два шага:
preview_payoutпоказывает сумму и комиссию,create_payoutотправляет с собственнымidempotency_keyагента — повтор никогда не платит дважды. - Тестовый режим: счёт с environment test проходит весь путь без реальных денег.
- Лимиты: несколько новых аккаунтов в час с одного IP; выплаты — 5 в минуту и 30 в час на ключ.
- Что можно и что нельзя продавать: Правила
Без MCP
То же самое работает через REST API: аккаунт — одним запросом, дальше Merchant API с ключом.
curl -X POST https://pay.snapex.pro/api/v1/merchant/signup -H 'Content-Type: application/json' -d '{"agent":"my-agent"}'