@pay-skill/mcp

Name: pay-mcp
Author: pay-skill

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). Последующие запуски загружают его автоматически.

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

Переменная окружения	Обязательно	По умолчанию	Описание
`PAYSKILL_SIGNER_KEY`	Нет	—	Опциональная замена. Необработанный hex-ключ или пароль от хранилища `.enc`. Не требуется для обычного использования.
`PAY_NETWORK`	Нет	`mainnet`	`mainnet` (Base) или `testnet` (Base Sepolia)

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

Системная связка ключей (по умолчанию) — Загружается из хранилища учетных данных ОС через keytar. При первом запуске генерируется новая пара ключей и сохраняется автоматически.
Зашифрованное хранилище ключей — Если существует файл ~/.pay/keys/default.enc, PAYSKILL_SIGNER_KEY используется как пароль для расшифровки.
Необработанный hex-ключ — Если PAYSKILL_SIGNER_KEY является 64-символьной hex-строкой, он используется напрямую. Для разработки/тестирования или импорта существующего кошелька.
Автогенерация — Если ничего из вышеперечисленного не найдено, генерируется новая пара ключей и сохраняется в системной связке ключей.

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

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

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_SIGNER_KEY)

Лицензия

MIT

Часть экосистемы Pay

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

Документация
Архитектура
SDK — Python + TypeScript
CLI — Инструмент командной строки
pay-gate — Платежный шлюз x402
Протокол — Смарт-контракты

pay-mcp