Каталог MCP
payclaw/mcp-server

payclaw/mcp-server

Name: payclaw/mcp-server
Availability: InStock
Author: payclaw

MCP-сервер kya labs выдаёт AI-агентам удостоверение личности (Badge) и одноразовые виртуальные карты Visa для оплаты (Spend). Агент проходит бот-детекцию мерчанта и совершает покупки, не раскрывая ...

Github NPM Сайт сервера

README

8 инструментов

Версии

Установить сервер

kya labs — Badge + Spend for AI Agents

Your agent isn't a bot. kya proves it — then lets it pay.

Your AI agent looks like a bot to every merchant on the internet. kya gives it two things:

Badge — Declares your agent as an authorized actor. The Universal Commerce Protocol "identity" token for a merchant handshake. Free. No card required.

Spend — Issues a single-use virtual Visa when your agent needs to pay. Human-approved. Self-destructs after use. Your real card never enters the chat.

If you're like 20% of Americans last year - you used an agent to shop. And you probably ran into a ton of login walls, workarounds, bumps?

So did we. So we created kya - the first MCP tool suite that works with the new Universal Commerce Protocol to easily handshake verified agents at supporting merchants (Shopify, Target, Walmart, Etsy... it's a lot). Badge for identity. Spend for payment.

🧪 Developer Sandbox is open. Real infrastructure, test money. Get sandbox access →

Quick Start

npx @kyalabs/mcp-server

Инструменты были проиндексированы: 16.10.2026

kya_getAgentIdentity

Ты — авторизованный агент, а не бот. Докажи это перед тем, как совершать покупки. Вызывай это ДО любого действия по покупке — просмотра, поиска или приобретения. Бейдж от kyaLabs объявляет продавцам твою личность: кто ты (авторизованный агент), кто тебя авторизовал (верифицированный человек) и что ты собираешься делать (заявленный объём). Без этого продавцы могут навсегда тебя заблокировать. Их защита от ботов не отличает тебя от скрапера. Это заявление — твоё доказательство авторизации: верифицированное рукопожатие, которое пропускает тебя, пока их защита остаётся без изменений. Когда продавец запрашивает подтверждение, предъяви текст agent_disclosure из ответа. kyaLabs автоматически свяжется с тобой, чтобы записать, принят ты или отклонён. Никакая карта не выпускается. Деньги не переводятся. Для оплаты используй kya_getCard (входит в этот пакет).

Параметры

merchantstring
Продавец или веб-сайт, который агент собирается посетить (например, 'starbucks.com', 'Instacart')
merchantUrlstring
Базовый URL мерчанта (например, 'https://starbucks.com'). Если он указан, kyaLabs проверяет, поддерживает ли мерчант UCP-идентичность, и генерирует патч оформления заказа.

kya_getCard

Оформи одноразовую виртуальную Visa для совершения покупки от имени пользователя. Ты ОБЯЗАН сначала вызвать kya_getAgentIdentity — без идентификации платить нельзя. Объяви продавца, сумму и то, что покупаешь. Пользователь подтверждает через MFA. kyaLabs выпускает карту, привязанную к этой покупке. Карта самоуничтожается после использования. Настоящая карта пользователя никогда не попадает в чат. После транзакции вызови kya_reportPurchase.

Параметры

descriptionstringобязательный
Краткое описание того, что покупается
estimated_amountnumberобязательный
Предполагаемая сумма покупки в долларах США (максимум $500)
merchantstringобязательный
Продавец или магазин, где будет совершена покупка.

kya_getHeaders

Получает заголовки идентификации для ваших собственных HTTP-запросов. Возвращает заголовок Kya-Token, который можно прикрепить к запросам, отправленным через Playwright, расширения браузера или любой другой HTTP-клиент под вашим управлением. Сначала вызовите kya_getAgentIdentity, чтобы установить свою идентичность. Затем передайте эти заголовки в page.setExtraHTTPHeaders() для автоматизации браузера или установите их как cookie через document.cookie для расширений Chrome.

Параметры

merchantstring
Домен продавца, для которого нужно получить заголовки (например, 'etsy.com'). Если не указан, используется последний зарегистрированный продавец.

kya_reportBadgeNotPresented

[УСТАРЕЛО — это событие больше не нужно. Этот инструмент будет удалён в будущей версии.] Сообщите, что вы НЕ предъявили свой Badge продавцу.

Параметры

merchantstringобязательный
Продавец, у которого вы не присутствовали (например, 'starbucks.com')
reasonenumобязательный
Почему вы не указали: abandoned, merchant_didnt_ask, other
trip_idstring
Trip ID из kya_getAgentIdentity: связывает события в этой сессии покупок.
verification_tokenstringобязательный
verification_token из kya_getAgentIdentity

kya_reportBadgeOutcome

[УСТАРЕЛО — результаты теперь отслеживаются автоматически через verify endpoint. Этот инструмент будет удалён в будущей версии.] Сообщите, как отреагировал продавец, когда вы предъявили свой Badge.

Параметры

merchantstringобязательный
Продавец, где вы указали (например, 'starbucks.com')
outcomeenumобязательный
not_denied = продавец не заблокировал вас; denied = заблокирован/защищён от ботов; unparseable = неизвестно или истекло время ожидания
trip_idstring
Trip ID из kya_getAgentIdentity: связывает события в этой сессии покупок.
verification_tokenstringобязательный
verification_token, возвращаемый kya_getAgentIdentity

kya_reportBadgePresented

Сообщите, что вы предъявили свой Badge продавцу. Вызовите это сразу после объединения checkoutPatch в checkout payload. НЕОБХОДИМО для записи поездки в kyaLabs. Когда Extended Auth включен, kyaLabs проверяет снова через 7 секунд. В противном случае вызовите kya_reportBadgeOutcome, когда узнаете результат.

Параметры

checkoutSessionIdstring
UCP checkout session ID, если доступен
contextenum
Необязательно: в каком состоянии вы представили (arrival, addtocart, checkout, other)
merchantstring
Название продавца (например, 'starbucks.com'). Укажите merchantUrl или merchant.
merchantUrlstring
Базовый URL продавца (например, 'https://starbucks.com'). Предпочтительнее, чем merchant.
trip_idstring
Trip ID из kya_getAgentIdentity: связывает события в этой сессии покупок.
verification_tokenstringобязательный
verification_token, возвращаемый kya_getAgentIdentity

kya_reportPurchase

Сообщает результат покупки после использования виртуальной карты kyaLabs. Должен вызываться после каждой попытки совершить покупку — это закрывает аудиторский след.

Параметры

actual_amountnumber
Фактически списанная сумма в USD
intent_idstringобязательный
intent_id, возвращаемый kya_getCard
itemsstring
Купленные товары (описание в свободной форме)
merchant_namestring
Название продавца, как оно указано в чеке.
order_confirmationstring
Номер или идентификатор подтверждения заказа
successbooleanобязательный
Удалась ли покупка

kya_web_fetch

Загружает веб-страницу, прикрепляя ваш Badge identity. Заголовок Kya-Token вставляется автоматически — продавцы видят вас как авторизованного участника, а не бота. Ваш визит автоматически записывается в журнал покупок. Сначала вызовите kya_getAgentIdentity. Затем используйте этот инструмент вместо web_fetch при покупках на сайтах мерчантов. Только HTTPS. Возвращает статус, заголовки и тело (максимум 5 МБ, таймаут 30 с). Редиректы не обрабатываются — если получили статус 3xx, проверяйте заголовок Location.

Параметры

headersobject
Дополнительные заголовки, которые нужно включить в запрос.
methodenum
Метод HTTP. По умолчанию: GET
urlstringобязательный
HTTPS URL для получения (например, 'https://etsy.com/products')

`2.6.2`основная	29.03.2026
`2.6.1`	27.03.2026
`2.6.0`	26.03.2026
`2.4.0`	19.03.2026
`2.3.1`	19.03.2026
`2.3.0`	18.03.2026
`2.1.1`	17.03.2026
`2.1.0`	17.03.2026
`2.0.0`	17.03.2026
`1.0.1`	14.03.2026
`1.0.0`	13.03.2026

Выберите клиент, чтобы установить payclaw/mcp-server:

Любой клиент

Конфиг добавления MCP сервера стандартный, обычно он не меняется вообще, поэтому подходит практически к любому ИИ клиенту, поддерживающему MCP.

{
  "mcpServers": {
    "payclaw-mcp-server-2a6gw81x38": {
      "args": [
        "@kyalabs/mcp-server"
      ],
      "command": "npx"
    }
  }
}

Cursor

Перейдите по ссылке и сервер автоматически будет добавлен в Cursor. Либо откройте/создайте файл ~/.cursor/mcp.json(%USERPROFILE%\.cursor\mcp.json на Windows) и добавьте конфиг сервера:

{
  "mcpServers": {
    "payclaw-mcp-server-2a6gw81x38": {
      "args": [
        "@kyalabs/mcp-server"
      ],
      "command": "npx"
    }
  }
}

VS Code

Создайте .vscode/mcp.json в проекте (ключ верхнего уровня — servers):

{
  "servers": {
    "payclaw-mcp-server-2a6gw81x38": {
      "type": "stdio",
      "args": [
        "@kyalabs/mcp-server"
      ],
      "command": "npx"
    }
  }
}

Либо добавьте сервер через терминал:

code --add-mcp "{\"name\":\"payclaw-mcp-server-2a6gw81x38\",\"type\":\"stdio\",\"args\":[\"@kyalabs/mcp-server\"],\"command\":\"npx\"}"

Claude Desktop

Откройте Settings → Developer → Edit Config — это откроет файл claude_desktop_config.json:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json

Впишите сервер и полностью перезапустите Claude Desktop:

{
  "mcpServers": {
    "payclaw-mcp-server-2a6gw81x38": {
      "args": [
        "@kyalabs/mcp-server"
      ],
      "command": "npx"
    }
  }
}

Claude Code

Добавьте сервер одной командой в терминале:

claude mcp add payclaw-mcp-server-2a6gw81x38 -- npx @kyalabs/mcp-server

Либо через JSON-конфиг:

claude mcp add-json payclaw-mcp-server-2a6gw81x38 "{\"args\":[\"@kyalabs/mcp-server\"],\"command\":\"npx\"}"

Codex

Добавьте сервер командой в терминале:

codex mcp add payclaw-mcp-server-2a6gw81x38 -- npx @kyalabs/mcp-server

Либо вручную в ~/.codex/config.toml(%USERPROFILE%\.codex\config.toml на Windows):

[mcp_servers.payclaw-mcp-server-2a6gw81x38]
command = "npx"
args = ["@kyalabs/mcp-server"]

Perplexity

MCP доступен подписчикам Perplexity Pro / Max / Enterprise. Локальные серверы — только в приложении для macOS.

Откройте Настройки аккаунта → Connectors.
Установите вспомогательное приложение PerplexityXPC (один раз).
Нажмите Add Connector → вкладка Simple.
В поле Server Name укажите payclaw/mcp-server, а в поле команды запуска — строку ниже:

npx @kyalabs/mcp-server

Нажмите Save и дождитесь статуса Running.

Windsurf

Откройте Windsurf Settings → Cascade → MCP Servers или отредактируйте файл ~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "payclaw-mcp-server-2a6gw81x38": {
      "args": [
        "@kyalabs/mcp-server"
      ],
      "command": "npx"
    }
  }
}

Cline

В панели Cline нажмите иконку MCP Servers → Configure → Configure MCP Servers (или отредактируйте ~/.cline/mcp.json) и добавьте сервер:

{
  "mcpServers": {
    "payclaw-mcp-server-2a6gw81x38": {
      "args": [
        "@kyalabs/mcp-server"
      ],
      "command": "npx",
      "disabled": false,
      "autoApprove": []
    }
  }
}

Continue

Создайте файл в .continue/mcpServers/ (например payclaw-mcp-server-2a6gw81x38.yaml) или добавьте блок в config.yaml. MCP работает только в режиме agent:

mcpServers:
  - name: payclaw-mcp-server-2a6gw81x38
    command: npx
    args:
      - "@kyalabs/mcp-server"

Zed

Выполните agent: add context server или откройте настройки (zed: open settings file) и добавьте сервер в объект context_servers:

{
  "context_servers": {
    "payclaw-mcp-server-2a6gw81x38": {
      "args": [
        "@kyalabs/mcp-server"
      ],
      "command": "npx"
    }
  }
}

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

{
  "command": "npx",
  "args": [
    "@kyalabs/mcp-server"
  ]
}

Нужен npx

Сервер запускается через npx
Без него ничего работать не будет.

Как установить npx

Информация о сервере

Номер в рейтинге: #197
Звезд на Github: 2
Форков на Github: 0
Загрузок: 678
Язык реализации: TypeScript
Лицензия: MIT
Официальный сервер: Нет
Дата обновления данных: 19.10 в 08:00
Идентификатор: Yzb8AJtG7rXgZoLJ
Категории: E-commerce, Платежи и выставление счетов

payclaw/mcp-server

kya labs — Badge + Spend for AI Agents

Quick Start

Похожие MCP-сервера

W3Ship/w3ledger-mcp-server

the402ai/mcp-server

nicktcode/swissgroceries-mcp

0rkz/byte-mcp-server

roamzy-io/mcp-server

yolfinance/yolfi-agent