mpp-agent

Pay HTTP 402 API requests via Machine Payments Protocol clients.

1|Updated Jun 19, 2026
One-click install
npx skills add https://github.com/Lento47/arcana-community --skill mpp-agent-lento47
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: mpp-agent
Source: https://github.com/Lento47/arcana-community/tree/main/skills/payments/mpp-agent
Command: npx skills add https://github.com/Lento47/arcana-community --skill mpp-agent-lento47

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires mppx.

What problem does it solve? APIs that return HTTP 402 Payment Required block normal requests until a payment credential is attached. This Skill lets an agent actually pay those per-request charges using Machine Payments Protocol (MPP) clients instead of just logging the 402 response. ## Core Features & Use Cases - Multiple MPP clients: Choose between mppx, Tempo Wallet, Privy Agent CLI, AgentCash, or Stripe Link depending on the 402 challenge method and the user's funded wallet. - Challenge inspection and payment: Probe a URL with curl to confirm it speaks MPP, then pay the request and verify the receipt header. - Use Case: A merchant API returns HTTP 402 with a www-authenticate: tempo header. Install mppx, create an account, and run mppx <url> to complete the payment handshake and receive the actual API response. ## Quick Start Install mppx globally with npm, create an account, then run mppx against the URL that returned the 402 challenge to pay and retrieve the 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 API that returns HTTP 402 Payment Required?▼

Install mppx with npm, run mppx account create, then call mppx <url>. The client handles the 402 challenge and credential exchange automatically and prints the merchant's response on success.

Which MPP client should I use for per-request API payments?▼

Use Stripe Link via link-cli when the challenge advertises method="stripe" or Link is already configured. Use mppx for one-off paid calls and debugging, and Tempo Wallet when you want persistent spend controls and service discovery.

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 wallet, since Link will reject them.

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 on PATH.

Why does a 402 endpoint work without a funded wallet?▼

Some MPP endpoints charge $0.00 and only require a proof credential. These zero-amount challenges succeed without a funded wallet and should not be treated as broken.

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

No. This skill covers the client side only. For server-side MPP, use the mpp.dev quickstart and the mppx middlewares for Next.js, Hono, Express, or Elysia.