@xpayr/mcp-server v1.0.0 · Реестр: io.github.xpayrcom/xpayr-mcp-server · 21 инструмент

Сервер Model Context Protocol (MCP) для некастодиальной криптокоммерции.

Предоставьте агентам Claude Desktop, Cursor, VS Code Copilot, Windsurf, Cline и n8n нативный защищённый политиками доступ к 21 строго типизированному инструменту XPayr — создавайте мультичейн-платежи в USDT/USDC, проверяйте HMAC-вебхуки, отправляйте автономные платёжные намерения и моделируйте расщепления расчётов 99.5% / 0.5% в блокчейне.

21 инструментОхватывают чекаут, вебхуки, ИИ-агентов и казначейство мерчанта.
2 транспортаУдалённый JSON-RPC 2.0 (/api/mcp) + Локальный npx Stdio.
6 пакетов модулейОграничивайте контекстное окно через --suite flagship или all.
Защитные лимитыЛимиты на операцию, дневные бюджеты и очереди ручного одобрения.

Настройка IDE и агентских клиентов в 1 клик


        

Живая проверка в браузере → POST /api/mcp

Отправьте реальный запрос JSON-RPC 2.0 на живую конечную точку Streamable HTTP MCP от XPayr прямо с этой страницы.

// Click "Run tools/list" or "Run Fee Split ($250 USDC)" to inspect live JSON-RPC 2.0 output from https://xpayr.com/api/mcp

Все 21 официальный инструмент MCP

xpayr_health_check

Проверка работоспособности API-шлюза

Проверьте операционный статус, версию и серверную метку времени XPayr Gateway API v1.

GET /health Публичный (Без ключа)
xpayr_create_payment_session

Создать сессию криптоплатежа (Двойной Checkout)

Создайте некастодиальную сессию криптооплаты с поддержкой оплаты Web3 в 1 клик, прямого биржевого QR-перевода, мультисетевых ссылок, многоразовых ссылок на 1 год и автоматической отправки HTML-инвойсов по email.

POST /payments Bearer sk_test / sk_live
xpayr_get_payment_session

Получить детали платёжной сессии

Получите полные данные, метаданные, суммы распределения расчётов, режим оплаты и ончейн-хеш транзакции для платёжной сессии.

GET /payments/{session_id} Bearer sk_test / sk_live
xpayr_list_payment_sessions

Список платёжных сессий мерчанта

Просматривайте криптоплатёжные сессии мерчанта с фильтрацией по статусу, валюте, сети и пагинацией.

GET /payments Bearer sk_test / sk_live
xpayr_get_public_payment_status

Опрос публичного ончейн-статуса платежа

Запрашивайте публичный статус оплаты в реальном времени, ончейн tx_hash, адрес кошелька отправителя, подтверждения блоков и метку paid_at без API-ключа.

GET /payments/{session_id}/status Публичный (Без ключа)
xpayr_apply_payment_coupon

Применить скидочный купон при оплате

Проверьте и примените промокод на скидку мерчанта к активной ожидающей сессии оплаты.

POST /payments/{session_id}/coupon Публичный (Без ключа)
xpayr_get_merchant_profile

Получить профиль мерчанта и кошелёк расчётов

Получите аутентифицированный профиль мерчанта, адрес кошелька для расчётов, ставку комиссии в базисных пунктах (50 bps = 0.5%) и активные API-ключи.

GET /me Bearer sk_test / sk_live
xpayr_get_merchant_balance

Получить мультисетевой объём расчётов и баланс

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

GET /me/balance Bearer sk_test / sk_live
xpayr_get_supported_networks

Список поддерживаемых сетей, чейнов и токенов

Получите список всех активных блокчейн-сетей EVM, TRON, Solana и Arc Mainnet/Testnet, ID сетей, RPC-узлов, контрактов-сплиттеров и поддерживаемых токенов.

GET /me/networks Bearer sk_test / sk_live
xpayr_get_webhook_config

Получить конфигурацию и события вебхуков

Просмотрите URL обратного вызова вебхука мерчанта, замаскированный секрет подписи HMAC-SHA256 и подписки на события жизненного цикла платежа.

GET /webhooks Bearer sk_test / sk_live
xpayr_set_webhook_endpoint

Настроить HTTPS-эндпоинт вебхука

Настройте или обновите HTTPS URL получателя вебхуков мерчанта и сгенерируйте новый 32-байтовый секретный ключ подписи HMAC-SHA256.

POST /webhooks Bearer sk_test / sk_live
xpayr_send_test_webhook

Отправить подписанное тестовое событие вебхука

Отправьте подписанную полезную нагрузку test.webhook с заголовками HMAC-SHA256 для проверки верификации подписи вебхуков на стороне мерчанта.

POST /webhooks/test Bearer sk_test / sk_live
xpayr_create_ai_agent

Создать ИИ-агента коммерции с контролем политик

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

POST /agents Bearer sk_test / sk_live
xpayr_list_ai_agents

Список ИИ-агентов коммерции мерчанта

Просмотрите всех управляемых мерчантом ИИ-агентов коммерции вместе с их статусом, назначенными кошельками и политиками расходов.

GET /agents Bearer sk_test / sk_live
xpayr_update_ai_agent_policy

Обновить лимиты расходов ИИ-агента

Настройте ограничения политики расходов для ИИ-агента (макс. USD за транзакцию, дневной лимит, порог автоодобрения, разрешённые сети и токены).

PUT /agents/{agent_id}/policy Bearer sk_test / sk_live
xpayr_submit_agent_payment_intent

Отправить автономное платёжное намерение ИИ-агента

Отправьте автономное платёжное намерение ИИ-агента, оцениваемое в реальном времени по правилам политики мерчанта (approved, pending_approval, rejected).

POST /agent-intents Bearer agk_test / agk_live
xpayr_list_agent_payment_intents

Список платёжных намерений ИИ-агентов и журналов аудита

Просмотрите платёжные намерения ИИ-агентов, решения по оценке политик и записи аудиторского следа для мерчанта.

GET /agent-intents Bearer sk_test / sk_live
xpayr_bridge_agent_intent_to_checkout

Преобразовать одобренное намерение агента в сессию оплаты

Преобразуйте одобренное платёжное намерение ИИ-агента в активную исполняемую платёжную сессию XPayr с размещённым URL оплаты и ончейн-проверкой.

POST /agent-intents/{intent_id}/bridge Bearer sk_test / sk_live
xpayr_approve_agent_intent

Одобрить ожидающее намерение ИИ-агента (с участием человека)

Одобрите ожидающее платёжное намерение ИИ-агента из очереди подтверждения мерчанта и переведите его в сессию оплаты.

POST /agent-approvals/{intent_id}/approve Bearer sk_test / sk_live
xpayr_reject_agent_intent

Отклонить ожидающее намерение ИИ-агента

Отклоните ожидающее платёжное намерение ИИ-агента в очереди подтверждения мерчанта с указанием причины для аудита.

POST /agent-approvals/{intent_id}/reject Bearer sk_test / sk_live
xpayr_calculate_gateway_fee_and_split

Калькулятор разделения комиссии шлюза 0.5% и биржевого допуска

Детерминированно рассчитайте распределение фиксированной комиссии шлюза XPayr 0.5% (50 bps), чистую выплату на кошелёк мерчанта, допуск на вывод с биржи 1% (макс. $0.50) и экономию по сравнению с BitPay, Coinbase Commerce и Stripe.

LOCAL /tools/crypto-payment-fee-calculator Офлайн / Публичный

Частые вопросы о MCP-сервере XPayr

Подключаться через удалённый Streamable HTTP (/api/mcp) или локально через npx (@xpayr/mcp-server)?

Оба варианта предоставляют все 21 инструмент XPayr с идентичными схемами. Удалённый Streamable HTTP (https://xpayr.com/api/mcp) не требует локального Node.js и сразу работает в облачных агентах, n8n и современных IDE; npx -y @xpayr/mcp-server@1.0.0 запускается локально через stdio и поддерживает фильтрацию модулей (--suite flagship,checkout).

Могут ли ИИ-агенты вызывать публичные инструменты MCP без API-ключа?

Да. Публичное обнаружение, проверка состояния шлюза (xpayr_health_check), детерминированный расчёт расщепления 0.5% (xpayr_calculate_gateway_fee_and_split) и опрос статуса публичных сессий работают без авторизации. Инструменты создания платежей и агентских намерений используют ваш ключ sk_test_ или sk_live_.

Как защитные лимиты предотвращают перерасход средств из-за галлюцинации LLM?

Коммерческие ИИ-агенты XPayr принудительно проверяют на стороне сервера лимиты на транзакцию, скользящие суточные бюджеты, пороги автоодобрения, белые списки сетей/токенов и очереди подтверждения человеком (/agent-commerce) до любого движения средств в блокчейне.

Где опубликован и верифицирован MCP-сервер XPayr?

XPayr MCP опубликован в npm (@xpayr/mcp-server@1.0.0), GitHub Container Registry (ghcr.io/xpayrcom/xpayr-mcp-server), официальном реестре MCP, Glama и Smithery, а документация доступна на https://mcp.xpayr.com и /.well-known/mcp.json.