Mpp Agent

Оплата HTTP 402 API через Machine Payments Protocol (MPP).

Метаданные навыка

Источник	Опционально — установка через vibeos skills install official/payments/mpp-agent
Путь	optional-skills/payments/mpp-agent
Версия	0.1.0
Автор	Teknium (teknium1), VibeOS
Лицензия	MIT
Платформы	linux, macos
Теги	Payments, MPP, HTTP-402, Tempo, Stripe
Связанные навыки	stripe-link-cli, stripe-projects

Справочник: полный SKILL.md

к сведению

Ниже приведено полное описание навыка, которое VibeOS загружает при его активации. Это инструкции, которые видит агент, когда навык активен.

Навык MPP Agent

Обёртка для клиентов Machine Payments Protocol (MPP, https://mpp.dev), позволяющая VibeOS оплачивать доступ к API на основе запросов, когда серверы отвечают HTTP 402 Payment Required.

Три варианта клиентов, все распространяются через npm. Выбирайте самый лёгкий, который решает задачу пользователя. Ограничено [linux, macos], пока инструментарий для платежей на Windows не станет зрелым.

Когда использовать

• API мерчанта возвращает HTTP 402 с заголовком www-authenticate — и пользователь хочет действительно оплатить запрос, а не просто залогировать ответ.
• Пользователь просит «оплатить за запрос», «настроить кошелёк агента», «использовать Tempo / Privy / AgentCash» или хочет найти сервисы с ценами через MPP.
• Трата через Stripe Link сгенерировала Shared Payment Token (SPT), и агенту нужно прикрепить его к вызову 402 — в этом случае предпочтительнее link-cli mpp pay (см. навык stripe-link-cli).

Выбор клиента

Инструмент	Когда	Настройка
link-cli	У пользователя уже настроен Stripe Link, или вызов 402 рекламирует method="stripe"	см. навык stripe-link-cli
Tempo Wallet	Сервисы MPP с контролем расходов и обнаружением сервисов	tempo wallet login
Privy Agent CLI	Мультичейн кошельки, пополнение через браузер	privy-agent-wallets login
AgentCash	300+ предоплаченных API через один баланс USDC.e	npx agentcash onboard
mppx	Разработка + отладка, минимальные зависимости	npm install -g mppx затем mppx account create

По умолчанию: если у пользователя уже настроен Stripe Link или вызов 402 указывает method="stripe", используйте link-cli mpp pay (навык stripe-link-cli). В противном случае — mppx для разовых платных вызовов и отладки, а Tempo Wallet — когда пользователю нужен постоянный контроль расходов.

Предварительные требования

• Node.js 20+ в PATH
• Пополненный кошелёк (Tempo / Privy / AgentCash) ИЛИ аккаунт mppx
• Для Tempo / Privy / AgentCash: следуйте соответствующим навыкам онбординга:
  • https://tempo.xyz/SKILL.md
  • https://agents.privy.io/skill.md
  • https://agentcash.dev/skill.md

Используйте web_extract, чтобы загрузить любой из этих SKILL.md, если пользователь выберет один из них.

Процедура (mppx, самый быстрый путь)

Все команды выполняются через инструмент terminal.

1. Установка + создание аккаунта

npm install -g mppx
mppx account create

Сохраните полученные учётные данные аккаунта там, где укажет CLI (CLI записывает их в свою конфигурацию — не вставляйте их в транскрипт агента).

2. Проверка вызова 402 мерчанта

Если пользователь дал вам URL, сначала проверьте его, чтобы убедиться, что он действительно использует MPP:

curl -i <url>

Настоящий MPP 402 выглядит так:

HTTP/1.1 402 Payment Required
www-authenticate: tempo amount=0.1 currency=...

3. Оплата запроса

mppx <url>

Для методов, отличных от GET, или для тела запроса:

mppx <url> --method POST --data '<json>'

mppx автоматически обрабатывает вызов 402 и обмен учётными данными, а в случае успеха выводит фактический ответ мерчанта.

4. Проверка квитанции

mppx автоматически добавляет заголовок квитанции. Для просмотра:

mppx <url> -v

Процедура (Tempo Wallet)

Навык Tempo Wallet по адресу https://tempo.xyz/SKILL.md является каноническим справочником; загрузите его с помощью web_extract и следуйте инструкциям. Основные команды:

tempo wallet login
tempo wallet pay <url>

Контроль расходов и обнаружение сервисов доступны в интерфейсе кошелька по адресу https://wallet.tempo.xyz.

Подводные камни

• HTTP 402 без method="stripe" нельзя оплатить через Stripe Link. Если вызов рекламирует только Tempo / другие методы, используйте mppx (или соответствующий кошелёк) — Link отклонит его. И наоборот, если рекламируется method="stripe", предпочтительнее Link через навык stripe-link-cli, чтобы трата прошла через одобренную карту пользователя.
• Несколько вызовов в одном заголовке. www-authenticate может перечислять несколько методов (например, tempo, stripe). CLI Link с помощью mpp decode выберет Stripe; mppx выберет Tempo. Единственного «правильного» клиента нет — выбирайте по тому, какой кошелёк пополнил пользователь.
• Вызовы с нулевой суммой. Некоторые конечные точки MPP взимают $0.00 и требуют только подтверждающее учётное данное. Они работают без пополненного кошелька. Не отказывайте в их обработке, считая их «сломанными».
• Ключи кошелька никогда не попадают в контекст агента. Все четыре клиента хранят ключи в своих собственных конфигурационных каталогах (или генерируют эфемерные пары ключей на сессию, как в случае Privy). Не используйте cat/read_file для их чтения.
• Серверная сторона MPP — это другой навык. Если пользователь хочет ДОБАВИТЬ 402 в своё собственное API, этот навык не подходит — направьте его на https://mpp.dev/quickstart/server и middleware mppx/nextjs / mppx/hono / mppx/express / mppx/elysia. Выделенный навык mpp-server может появиться позже.

Проверка

mppx --version && mppx account list

Код возврата 0 означает, что установка прошла успешно и аккаунт существует.