mpp-agent

Pays HTTP 402 API requests via Machine Payments Protocol clients.

1|Updated Feb 17, 2026
One-click install
npx skills add https://github.com/brittb-dev/zerogravityclaw --skill mpp-agent-brittb-dev
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: mpp-agent
Source: https://github.com/brittb-dev/zerogravityclaw/tree/main/src/hermes-core/optional-skills/payments/mpp-agent
Command: npx skills add https://github.com/brittb-dev/zerogravityclaw --skill mpp-agent-brittb-dev

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires mppx.

What problem does it solve? Merchant APIs increasingly respond with HTTP 402 Payment Required, and agents need a way to actually pay per-request charges instead of just logging the rejection. This Skill wraps Machine Payments Protocol (MPP) clients so an agent can complete the 402 challenge/credential flow and retrieve the paid response. ## Core Features & Use Cases - Multiple MPP clients: Choose between mppx, Tempo Wallet, Privy Agent CLI, AgentCash, or Stripe Link CLI depending on the challenge method and the user's funded wallet. - Challenge inspection: Probe a URL with curl to confirm it speaks MPP and decode the www-authenticate header before paying. - Automated payment flow: Run mppx against a URL to handle the 402 handshake automatically, including POST requests with JSON bodies and receipt verification. - Use Case: A user hits an API that returns HTTP 402 with a Tempo challenge. The agent installs mppx, creates an account, pays the request, and returns the merchant's actual response with the receipt header. ## Quick Start Ask the agent to pay the HTTP 402 charge on a given API URL using mppx and return the paid response.

Frequently Asked Questions about mpp-agent

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

FAQPage Schema
How do I pay an HTTP 402 Payment Required API from an agent?▼

Install mppx with npm, create an account, then run mppx followed by the URL. The CLI handles the 402 challenge and credential exchange automatically and prints the merchant's response on success.

Which MPP client should I use: mppx, Tempo, Privy, or AgentCash?▼

Use mppx for one-off paid calls and debugging, Tempo Wallet for persistent spend controls and service discovery, Privy for multi-chain wallets, and AgentCash for 300+ pre-priced APIs on one USDC.e balance. If the challenge specifies method="stripe", prefer the Stripe Link CLI.

Can Stripe Link pay any HTTP 402 challenge?▼

No. Stripe Link only pays challenges advertising method="stripe". Challenges offering only Tempo or other methods must be paid with mppx or a matching funded wallet, since Link will reject them.

Does mpp-agent work on Windows?▼

The Skill is gated to linux and macos platforms while the broader payments tooling matures on Windows. It also requires Node.js 20 or later available on PATH.

Why does a zero-amount 402 challenge still require a client?▼

Some MPP endpoints charge $0.00 and only want a proof credential. These work without a funded wallet and should not be treated as broken; the client still completes the credential exchange.

Can I use this Skill to add HTTP 402 payments to my own API?▼

No. This Skill covers the client side of paying 402 challenges. For server-side MPP, use the mpp.dev server quickstart with middlewares like mppx/nextjs, mppx/hono, mppx/express, or mppx/elysia.