testmpp
The public test endpoint for MPP — the Machine Payments Protocol. Send an agent payment, get an echo back. The free /echo verifies your HTTP plumbing for nothing; /pay/echo is live on Tempo mainnet and settles a real $0.01 USDC.e per call — so point a paying client at it only when you mean to spend.
LIVE free echo, spec-correct 402 challenges & on-chain settlement (mainnet)
Quickstart
See a real MPP challenge right now:
curl -i https://testmpp.com/pay/echo
You get 402 Payment Required with a WWW-Authenticate: Payment header — the standard MPP challenge (method tempo, intent charge, $0.01 in USDC.e on Tempo mainnet, chain 4217).
Pay it with the official MPP CLI. This spends a real $0.01 USDC.e — only run it with a funded mainnet account when you mean to:
npx mppx account create
# fund the account with real USDC.e on Tempo mainnet
npx mppx https://testmpp.com/pay/echo # settles $0.01 USDC.e for real
Want to rehearse the full pay-and-echo loop for free? Run your own testmpp instance against Moderato testnet — set MPP_CHAIN_ID=42431 and fund from the free faucet (pathUSD, no real money).
Just want to verify your HTTP plumbing without paying anything? The free echo returns whatever you send:
curl -s https://testmpp.com/echo -d '{"hello":"agent"}' | jq
Endpoints
| Endpoint | Cost | What it does |
|---|---|---|
GET /health | free | Liveness + network info. |
ANY /echo | free | Echoes your method, headers, and body back as JSON. Works today. |
ANY /pay/echo | $0.01 real USDC.e | Issues a spec-correct MPP 402 challenge (draft-ryan-httpauth-payment-01), then verifies and settles the payment on Tempo mainnet and returns the echo plus a Payment-Receipt header. A valid credential moves a real $0.01. |
Full reference, including the decoded challenge format: /docs.
What is MPP?
MPP (Machine Payments Protocol) is the open protocol for machine-to-machine payments over HTTP, launched by Stripe and Tempo on March 18, 2026. It gives the long-reserved HTTP 402 Payment Required status real semantics:
- Your agent requests a resource. The server answers
402with aWWW-Authenticate: Paymentchallenge (price, currency, recipient, chain). - The agent pays — Tempo stablecoins, Stripe cards, or other methods — and retries with an
Authorization: Paymentcredential. - The server verifies, settles, and returns the resource plus a
Payment-Receiptheader.
The core scheme is an IETF draft (draft-ryan-httpauth-payment-01), the spec lives at tempoxyz/mpp-specs, and it's backward-compatible with x402. If you're building agentic payments, agent commerce, or pay-per-request APIs, MPP is the rail — and testmpp is where you point your client first.
Why a test endpoint?
When agents are the ones paying, they need somewhere real to verify their payment plumbing end-to-end: does my client parse challenges? Sign credentials correctly? Handle receipts and expiry? testmpp answers that with real protocol traffic — like httpbin, but for agent payments. Start free against /echo or your own testnet instance, then prove the production rails against the live mainnet /pay/echo when you're ready to settle a real $0.01.
FAQ
- Does this cost real money?
- The free
/echonever costs anything./pay/echoruns on Tempo mainnet (chain 4217) with USDC.e, so a successful payment moves a real $0.01 — only point a paying client at it when you mean to spend. To test the full pay-and-echo loop for free, run your own testmpp instance against Moderato testnet (MPP_CHAIN_ID=42431) with pathUSD from the free faucet. - MPP vs x402?
- x402 (Coinbase → Linux Foundation) pioneered HTTP-native stablecoin payments with a facilitator model. MPP (Stripe + Tempo) is the IETF-track HTTP 402 formalization — method-agnostic, no facilitator required, backward-compatible with x402.
- What clients work?
- The official
mppxSDK (TypeScript, Python, Rust, Go, Ruby) and its CLI; MCP-capable agents viamppx mcp add; or raw HTTP if you build the credential yourself.