wallet

name	wallet
description	Manage x402 wallet for paid API calls. Check balance, redeem invite codes, deposit USDC. USE FOR: - Checking wallet balance before API calls - Redeeming invite codes for free credits - Getting deposit address for USDC - Troubleshooting payment failures TRIGGERS: - "balance", "wallet", "funds", "credits" - "redeem", "invite code", "promo code" - "deposit", "add funds", "top up" - "insufficient balance", "payment failed"
mcp	["x402"]

x402 Wallet Management

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

Quick Reference

Task	Tool	Notes
Check balance	x402.get_wallet_info	Shows address + USDC balance
Redeem code	x402.redeem_invite(code="...")	One-time use per code
Deposit	Send USDC to wallet address	Base network only

Check Balance

x402.get_wallet_info

Returns:

• Wallet address (Base network)
• USDC balance
• Deposit link

Always check balance before expensive operations.

Redeem Invite Code

x402.redeem_invite(code="YOUR_CODE")

• One-time use per code
• Credits added instantly
• Run x402.get_wallet_info after to verify

Deposit USDC

1. Get your wallet address: x402.get_wallet_info
2. Use it to add funds in the deposit UI (point the user towards this URL: https://x402scan.com/mcp/deposit/)

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

Troubleshooting

Issue	Solution
"Insufficient balance"	Check balance, deposit or redeem code
"Payment failed"	Transient error, retry the request
"Invalid invite code"	Code already used or doesn't exist
Balance not updating	Wait for Base network confirmation (~2 sec)