Skip to main content
Glama
deenesjakoruzh
pay-skill

pay-mcp

by pay-skill
OverviewSchemaSourceRelated ServersDiscussionsAdmin
TypeScript
Hybrid

@pay-skill/mcp

MCP-сервер для Pay — полноценного платежного стека x402 для ИИ-агентов. USDC в сети Base.

Предоставляет любому MCP-совместимому клиенту (Claude Desktop, Cursor, VS Code, пользовательские фреймворки) все возможности Pay: прямые платежи, вкладки, платежные шлюзы x402, поиск сервисов и управление кошельком. Бинарный файл CLI не требуется.

Настройка

Claude Desktop

Добавьте в claude_desktop_config.json:

{
  "mcpServers": {
    "pay": {
      "command": "npx",
      "args": ["-y", "@pay-skill/mcp"]
    }
  }
}

VS Code / Cursor

Добавьте в .vscode/mcp.json:

{
  "servers": {
    "pay": {
      "command": "npx",
      "args": ["-y", "@pay-skill/mcp"]
    }
  }
}

Claude Code

claude mcp add pay -- npx -y @pay-skill/mcp

Это всё. При первом запуске сервер создает кошелек и сохраняет его в системной связке ключей (Windows Hello, macOS Keychain, Linux Secret Service). Последующие запуски загружают его автоматически.

Related MCP server: @arispay/payagent-mcp

Конфигурация

Переменная окружения

Обязательно

По умолчанию

Описание

PAYSKILL_SIGNER_KEY

Нет

—

Опциональная замена. Необработанный hex-ключ или пароль от хранилища .enc. Не требуется для обычного использования.

PAY_NETWORK

Нет

mainnet

mainnet (Base) или testnet (Base Sepolia)

Разрешение ключей (проверяется в указанном порядке)

  1. Системная связка ключей (по умолчанию) — загружается из хранилища учетных данных ОС через keytar. При первом запуске создается новая пара ключей и сохраняется автоматически.

  2. Зашифрованное хранилище ключей — если существует файл ~/.pay/keys/default.enc, PAYSKILL_SIGNER_KEY используется как пароль для расшифровки.

  3. Необработанный hex-ключ — если PAYSKILL_SIGNER_KEY является 64-символьной hex-строкой, он используется напрямую. Для разработки/тестирования или импорта существующего кошелька.

  4. Автогенерация — если ничего из вышеперечисленного не найдено, создается новая пара ключей и сохраняется в системной связке ключей.

Диагностическая проверка

Убедитесь, что всё настроено правильно:

npx @pay-skill/mcp --check

Вывод:

pay-mcp diagnostic check
  network: Base (chain 8453)
  api:     https://pay-skill.com/api/v1
  wallet:  0x1234...
  key:     keychain
  server:  OK (router: 0xABCD...)
  auth:    OK (balance: $50.00)

All checks passed. MCP server is ready.

Инструменты (15)

Платежи

Инструмент

Описание

pay_send

Прямой платеж в USDC (мин. $1). Пороги подтверждения: <$10 авто, $10-100 план, >$100 явное подтверждение.

pay_request

HTTP-запрос с автоплатежом x402. Обрабатывает обнаружение 402, прямые/вкладочные расчеты, проверку цены.

Вкладки (счетчики аккаунтов)

Инструмент

Описание

pay_tab_open

Открыть предоплаченную вкладку (мин. $5, рекомендуется $50). Провайдер взимает плату за вызов.

pay_tab_close

Закрыть вкладку. Возвращает распределение (провайдер 99%, комиссия 1%, остаток агента).

pay_tab_charge

Списание со счета открытой вкладки (только для провайдера).

pay_tab_topup

Пополнение открытой вкладки (только для агента).

pay_tab_list

Список вкладок с флагами простоя/низкого баланса.

Кошелек

Инструмент

Описание

pay_status

Баланс, заблокированные/доступные средства, полезные рекомендации.

pay_fund

Создать 1-часовую ссылку для пополнения (Coinbase Onramp или прямой USDC).

pay_withdraw

Создать 1-часовую ссылку для вывода средств.

pay_mint

Минтинг тестового USDC (только Base Sepolia).

Поиск и вебхуки

Инструмент

Описание

pay_discover

Поиск платных API-сервисов по ключевым словам/категориям.

pay_webhook_register

Регистрация вебхука для платежных событий (с подписью HMAC).

pay_webhook_list

Список зарегистрированных вебхуков.

pay_webhook_delete

Удаление вебхука.

Ресурсы (5)

URI

Описание

pay://wallet/status

Баланс, вкладки, заблокированные/доступные средства

pay://wallet/tabs

Все открытые вкладки

pay://tab/{tab_id}

Детали отдельной вкладки

pay://wallet/address

Адрес кошелька

pay://network

Конфигурация сети + адреса контрактов

Промпты (3)

Промпт

Описание

pay-for-service

Пошагово: поиск сервиса, оценка стоимости, выполнение запроса

review-tabs

Просмотр вкладок, пометка неактивных, предложение закрыть/пополнить

fund-wallet

Создание ссылки для пополнения, объяснение процесса депозита

Разработка

git clone https://github.com/pay-skill/pay-mcp.git
cd pay-mcp
npm install
npm run build
npm test                    # unit tests (mocked)
npm run test:acceptance     # testnet (requires PAYSKILL_TESTNET_KEY)

Лицензия

MIT

Часть Pay

Pay — это полноценный платежный стек x402 — шлюз, фасилитатор, SDK, CLI и MCP-сервер, который позволяет ИИ-агентам оплачивать API с помощью USDC в сети Base.

This server cannot be deployed

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Maintenance

ActivityActive
ResponsivenessNo issues

Resources

Related MCP Connectors

Related MCP Servers