Toolchain
Overview
Install the pay CLI, configure accounts, and use the grouped command reference.
pay is a single binary that makes wallet-approved HTTP requests, runs AI agents that can pay for APIs, and gates your own services with stablecoin payments. It speaks the HTTP 402 family (x402 and MPP) and signs every payment with a Solana account stored in your OS secure store.
First run
brew install pay
pay --sandbox curl https://payment-debugger.vercel.app/mpp/quote/AAPLThe sandbox flag routes to a hosted Surfpool cluster and auto-funds an ephemeral wallet. No mainnet account, no top-up — payments are simulated end-to-end.
What's in this section
| Page | When you need it |
|---|---|
| Install | Get the binary onto your machine and verify it. |
| Configuration | pay.toml, accounts.yml, secure-store backends, file precedence. |
| Global flags | Network, account, protocol, debugger, automation flags + environment variables. |
| Commands | Full CLI reference, grouped the way pay --help groups them. |
| Troubleshooting | Common errors and the fix for each. |
For task-shaped workflows — paying for an API as a user, gating an API as an operator — see Using pay and Building with pay.