Agent-Skills.md

Agent Skills: x402 Wallet Management

|

UncategorizedID: merit-systems/x402scan-skills/wallet

Repository

merit-systems/x402scan-skills
Merit-Systems
33

Install this agent skill to your local

pnpm dlx add-skill https://github.com/Merit-Systems/x402scan-skills/tree/HEAD/skills/wallet

Skill Files

Browse the full folder contents for wallet.

Download Skill

Loading file tree…

skills/wallet/SKILL.md

Skill Metadata

Name
wallet
Description
|

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/<their-wallet-address>)

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) |