buy

Search the provider registry bundled with buy. This is read-only and never pays. Use it to find a service and its agent instructions, then fetch the service catalog and call buy_pay_quote before any purchase. An entry with stage "experimental" is an early-stage third-party seller buy has not reviewed: confirm with the user before paying it.

Call any URL. If the server returns 402 with an x402 challenge, buy signs an EIP-3009 USDC, USDT or USAT payment locally and retries with X-PAYMENT. If the challenge also demands a Self.xyz attestation, the matching one from the local keystore is attached as X-SELF-ATTESTATION (bound to the same wallet address). Use this instead of plain HTTP when calling paid APIs from your tool calls. Quote first with buy_pay_quote using the same method and body; if this tool then returns a 5xx or fails after the 402 challenge, the payment may still have settled, so do not re-send — report the outcome and any tx hash in this tool's output to the user.

Call any URL. If the server returns 402 with an x402 challenge, buy signs an EIP-3009 USDC, USDT or USAT payment locally and retries with X-PAYMENT. If the challenge also demands a Self.xyz attestation, the matching one from the local keystore is attached as X-SELF-ATTESTATION (bound to the same wallet address). Compatibility alias for buy_curl; prefer buy_curl in new integrations. Quote first with buy_pay_quote using the same method and body; if this tool then returns a 5xx or fails after the 402 challenge, the payment may still have settled, so do not re-send — report the outcome and any tx hash in this tool's output to the user.

List the buy accounts available in the local keystore, the active default, and each account address. Use this before buy_curl to confirm which wallet will sign payments.

List Self.xyz attestations stored on a buy account. Useful before calling a KYC-gated endpoint to confirm the wallet already has a matching attestation (scope, minimum age, OFAC, etc.). This tool cannot create an attestation: the user creates one with `buy verify hosted --endpoint <receiver-url>` against a gateway-hosted receiver, or `buy verify serve --scope <scope> --min-age N --ofac` locally.

Report the native (CELO) and ERC-20 stablecoin balances of a buy account — the same data as the `buy whoami` CLI command. Read-only: no keychain access, no signing. Use this before buy_send or buy_curl to confirm the wallet is funded.

DRY RUN — never pays, never signs, never touches the keychain. Fetches a URL once; if the server answers 402 with an x402 challenge, returns the price, network, asset, recipient, and any Self.xyz requirements so you can decide whether to pay before calling buy_curl. Run this before the first paid call to an endpoint: buy_curl settles without a quote, and a settled payment is irreversible.