agentcash-wallet

name

agentcash-wallet

description

Manage your agentcash wallet and call any x402-protected API with automatic payment. No API keys, no subscriptions — just a funded wallet (USDC on Base). USE FOR: - Checking wallet balance before API calls - Redeeming invite codes for free credits - Getting deposit address for USDC - Discovering endpoints and pricing on any x402-protected origin - Making paid API requests via the agentcash CLI - Troubleshooting payment failures TRIGGERS: - "balance", "wallet", "funds", "credits" - "redeem", "invite code", "promo code" - "deposit", "add funds", "top up" - "discover", "endpoints", "what APIs", "pricing" - "insufficient balance", "payment failed"

agentcash Wallet & Paid APIs

Call any x402-protected API with automatic payment. Payment is the authentication — no API keys or subscriptions needed.

Setup

If the agentcash CLI is not yet installed, see rules/getting-started.md for installation and wallet setup.

Wallet Management

Your wallet is auto-created on first use and stored at ~/.agentcash/wallet.json.

Check Balance

npx agentcash wallet info

Returns wallet address, USDC balance, and deposit link. Always check before expensive operations.

Redeem Invite Code

npx agentcash wallet redeem YOUR_CODE

One-time use per code. Credits added instantly. Run npx agentcash wallet info after to verify.

Deposit USDC

1. Get your wallet address via npx agentcash wallet info
2. Send USDC on Base network (eip155:8453) to that address
3. Or use the deposit UI: https://x402scan.com/mcp/deposit/<wallet-address>

Important: Only Base network USDC. Other networks or tokens will be lost.

Calling Paid APIs