mpp-agent

Pay HTTP 402 API requests via Machine Payments Protocol clients.

Updated Sep 10, 2026
One-click install
npx skills add https://github.com/loteiron/ZeusAgent --skill mpp-agent-loteiron
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: mpp-agent
Source: https://github.com/loteiron/ZeusAgent/tree/main/optional-skills/payments/mpp-agent
Command: npx skills add https://github.com/loteiron/ZeusAgent --skill mpp-agent-loteiron

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires mppx.

What problem does it solve? Some APIs now charge per request and respond with HTTP 402 Payment Required, which blocks normal API calls. This Skill lets the agent actually pay those challenges using Machine Payments Protocol (MPP) clients instead of just logging the failure. ## 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. - 402 challenge inspection: Probe merchant endpoints with curl to confirm they speak MPP and decode the www-authenticate header before paying. - Automated payment flow: mppx handles the challenge/credential exchange automatically and prints the merchant's real response with a receipt header. - Use Case: A user hits a paid data API that returns HTTP 402 with a Tempo challenge. The agent installs mppx, creates an account, pays the request, and verifies the receipt — all without wallet keys ever entering the transcript. ## Quick Start Ask the agent to pay the HTTP 402 challenge at a given URL using mppx and show the merchant's 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 response?▼

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

What is the Machine Payments Protocol (MPP)?▼

MPP is a protocol where servers respond with HTTP 402 and a www-authenticate header describing payment methods and amounts. Clients like mppx, Tempo Wallet, or Stripe Link pay the challenge and attach a receipt credential to retry the request.

mppx vs Tempo Wallet vs Stripe Link for MPP payments?▼

Use Stripe Link CLI when the challenge advertises method="stripe" or the user already has Link configured. Use mppx for one-off paid calls and debugging, and Tempo Wallet when persistent spend controls and service discovery are needed.

Can Stripe Link pay any HTTP 402 challenge?▼

No. Stripe Link only pays challenges that advertise method="stripe" in the www-authenticate header. Challenges offering only Tempo or other methods must be paid with mppx or a matching funded wallet.

Does mpp-agent work on Windows?▼

No. 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.

When should I not use the mpp-agent skill?▼

Do not use it to add 402 payments to your own API — that is server-side MPP, covered by mppx middlewares for Next.js, Hono, Express, or Elysia. This skill is strictly for paying merchant APIs as a client.