Install pay

Install the CLI before running client, agent, or server flows.

Agent summary

• Prefer Homebrew for normal local setup.
• Use pay setup --update when pay is installed but agent MCP config needs refreshing.
• Do not create or replace a mainnet account unless the user asked for account setup.
• Use sandbox mode when the user only needs local testing.

Install

brew install pay
pay --version

From source

git clone https://github.com/solana-foundation/pay.git
cd pay
just install pay
pay --version

Wallet setup

pay setup
pay topup

pay setup creates a wallet in supported local secure storage where available, including macOS Keychain, GNOME Keyring, Windows Hello, and 1Password.

Sandbox mode creates and funds an ephemeral local sandbox wallet automatically, so do not run mainnet account setup for a test-only flow.

Update agent config

pay setup --update

pay setup --update reinstalls MCP configuration and the agent skill without creating a new account.