How do I pay for an MPP API?
Short answer
Install an MPP client, give it a way to pay, and make your request through it. The reference client, mppx, patches fetch so that a 402 reply is paid and retried for you. With the Tempo method you need a wallet holding a stablecoin on Tempo. Other methods let you pay by card or Lightning. Clients exist for TypeScript, Python, Rust and Go.
What you need
- An MPP client library for your language.
- A way to pay that the seller accepts. That depends on the payment method: a funded wallet for Tempo, a card for the card method, a Lightning wallet for Lightning.
- The address of a paid endpoint.
Before writing code, paste the endpoint into the 402 checker. It lists the MPP payment methods the seller offers, so you know what you need to hold.
Install a client
npm install accounts mppx viem
mppx is the reference implementation, in TypeScript. The MPP site also lists pympp for Python, mpp-rs for Rust and mpp-go for Go.
Make a paid request
This is the pattern from the official client quickstart, using the Tempo payment method.
import { privateKeyToAccount } from 'viem/accounts'
import { Mppx, tempo } from 'mppx/client'
// Load the key from the environment. Never paste it into code.
const account = privateKeyToAccount(process.env.PRIVATE_KEY as `0x${string}`)
Mppx.create({
methods: [tempo({ account })],
})
const response = await fetch('https://mpp.dev/api/ping/paid')
Mppx.create replaces the global fetch. After that, an ordinary fetch call pays by itself when the seller answers 402, then returns the paid response.
The wallet must hold the currency the seller asks for, on the network it asks for.
Ways to hold the wallet
The quickstart shows three:
- A private key read from the environment on a server.
- The Accounts SDK, which connects a user's wallet.
- A Privy wallet, where a provider holds the key.
If you would like to approve each payment yourself, the client has a manual mode that hands you the payment to confirm before it is sent.
Try it from the command line
The mppx package includes a command-line tool. To make a paid request on the test network:
npx mppx account create --network testnet
npx mppx account fund --network testnet
npx mppx https://your-server.example/resource --network testnet
Test tokens have no value, so this is the safe way to see a full payment.
Paying without crypto
MPP is not limited to stablecoins. The payment methods list includes card, for card payments through encrypted network tokens, and stripe, for traditional payment methods through Stripe. Whether you can use one depends on the seller offering it. See MPP payment methods.
Keep it safe
The same habits apply as for x402:
- Use a separate wallet for paying APIs, with a small balance.
- Look at the price and recipient before you pay. The 402 checker shows both.
- Be careful giving an autonomous agent a funded wallet. It will pay for whatever it is persuaded to call. See is x402 safe?, which covers risks that apply to both protocols.
If the endpoint also takes x402
Many do. A server can offer both protocols in one 402 reply. If you already have an x402 client and USDC on a network the seller lists, you can pay that way. See how to pay an x402 API and x402 vs MPP.
Sources
- MPP client quickstart, mpp.dev
- MPP server quickstart, mpp.dev (command-line tool)
- MPP payment methods
- MPP overview, mpp.dev
Facts checked against these sources on . Protocols change, so the official specification wins if it disagrees with this page. Read this page as Markdown.
Related questions
Who writes this. Ask402 is published by Havok Holdings LLC, which also runs Agent402, one of the x402 services covered here. Agent402 is labelled wherever it appears. Everything else is described from each project’s own documentation, and nobody pays to be listed.