mpp-agent

Enable per-request payments for HTTP 402 APIs using the Machine Payments Protocol.

78|16|Updated Apr 23, 2026
One-click install
npx skills add https://github.com/sheawinkler/hermes-agent-ultra --skill mpp-agent
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: mpp-agent
Source: https://github.com/sheawinkler/hermes-agent-ultra/tree/main/optional-skills/payments/mpp-agent
Command: npx skills add https://github.com/sheawinkler/hermes-agent-ultra --skill mpp-agent

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Pay-per-request access to paid APIs can be blocked behind a 402 Payment Required wall. This skill wraps MPP clients so Hermes can automatically credential and pay for per-call API access.

Core Features & Use Cases

  • Multi-client support: integrate with Tempo Wallet, Privy, AgentCash, and mppx to handle wallet-based payments.
  • Guided client selection: choose the optimal client based on the 402 challenge method (e.g., tempo, stripe, or other wallets).
  • Safe, auditable flows: keeps wallet keys in per-client configurations and avoids exposing sensitive data in the agent context.

Quick Start

Install an MPP client and run a sample payment against a 402 endpoint.

Frequently Asked Questions about mpp-agent

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I handle HTTP 402 Payment Required errors for API requests?

To handle HTTP 402 Payment Required errors, you need per-request payments via the Machine Payments Protocol (MPP). This skill wraps MPP clients so your agent can automatically credential and pay for blocked API access per call.

What is the Machine Payments Protocol and when do I need it for API access?

The Machine Payments Protocol (MPP) enables automated, per-request payments for APIs. You need it when pay-per-request access is blocked behind a 402 Payment Required wall, allowing agents to automatically credential and pay for calls.

How do I choose the right MPP client for a 402 challenge method?

Choosing the right MPP client depends on the 402 challenge method returned by the endpoint. This skill provides guided client selection, matching the challenge method (e.g., tempo, stripe) to the optimal wallet client like Tempo Wallet, Privy, or AgentCash.

Do I need Node.js to automate API payments with MPP?

Yes, you need Node.js 20+ to automate API payments with MPP. Additional prerequisites include a funded wallet and completing per-client onboarding as described in the included workflow before executing sample payments.

How do I keep wallet keys safe when automating per-call API payments?

To keep wallet keys safe when automating per-call API payments, this skill stores keys in per-client configurations. This approach avoids exposing sensitive wallet data directly in the agent context during payment flows.

Can I use Tempo Wallet or Privy to pay for 402 API endpoints?

Yes, you can use Tempo Wallet, Privy, AgentCash, or mppx to pay for 402 API endpoints. The skill supports multiple clients, guiding you to pick the right tool based on the specific challenge method returned.