# ClawCard — Quick Reference for AI Agents The complete identity for AI agents — email, phone, virtual cards, ~300 paid API capabilities, and more. One API key gives you a full identity: email inbox, SMS-enabled US phone number, virtual Mastercards with spend limits, one balance for API calls and cards, and encrypted secret storage. ## When to Use ClawCard - You need to buy something online and need a virtual card with a hard spending limit - You need to sign up for a service and need a real email address or phone number - You need to receive verification codes via SMS or email - You need to store or retrieve API keys and secrets securely - You need to send emails on behalf of your task - You need to call a paid API (search, scrape, enrich, generate images, etc.) - You need to send or receive USDC on Base - A human has asked you to purchase, sign up for, or manage something that requires payment or identity ## When NOT to Use ClawCard - You need a physical card for in-store purchases (these are virtual cards, online only) - You need to send money directly to a person (use a payment service instead) - The merchant requires interactive 3DS/SMS verification on a card you don't control ## Install npm install -g @clawcard/cli ## Authenticate (human does this once) clawcard signup # create an account clawcard login # or log in to existing account ## Create a key clawcard keys create ## Set up your agent clawcard setup # Installs the ClawCard skill for your agent (via skills.sh) # Auto-detects your harness: Claude Code, Cursor, Codex, Cline, OpenClaw, etc. # Writes CLAWCARD_API_KEY to ~/.clawcard/.env --- ## CLI Commands (for agents) All commands support --json for machine-readable output. Always pass --json when calling from an agent. ### Identity clawcard agent info --json Returns: name, email, phone, keyId, budget ### Email clawcard agent emails --json [--limit 20] [--unread] List inbox. clawcard agent emails send --to "user@example.com" --subject "Subject" --body "Body" --json Send email. clawcard agent emails read --json Mark as read. ### SMS clawcard agent sms --json [--limit 20] List messages. clawcard agent sms send --to "+15551234567" --body "Message" --json Send SMS. ### Virtual Cards Two card types (you MUST specify one when creating): single_use — Auto-closes after one successful charge. Use for one-time purchases (domains, invoices). merchant_locked — Locks to first merchant, allows repeat charges. Use for subscriptions (hosting, SaaS tools). Reusing a merchant_locked card does NOT count against your monthly card limit. IMPORTANT: Before creating a new card, always list existing cards. If there's an open merchant_locked card for the same merchant, reuse it. clawcard agent cards --json List all cards. Look for status: "open". clawcard agent cards create --amount --type --memo "desc" --json Create card. Returns: pan, cvv, exp_month, exp_year. clawcard agent cards details --json Get card details (PAN, CVV, expiry) for any open card. clawcard agent cards close --json Close card permanently. ### Crypto Wallet Three asset types: ETH — Gas for on-chain transactions ($1-2 covers thousands of txns on Base) USDC — x402 API payments and direct transfers pathUSD — MPP (Machine Payments Protocol) payments on Tempo network clawcard agent wallet --json Show wallet address, network, and all balances (USDC, ETH, pathUSD). clawcard agent wallet balance --json Check balances. Returns: balanceUsdc, balanceEth, balancePathUsd, fiatBudgetCents, effectiveUsdc. clawcard agent wallet fund Interactive wizard — choose what to fund: 1. Gas fees (ETH) — Buy via Coinbase 2. x402 services (USDC) — Buy via Coinbase (zero fees) 3. MPP services (pathUSD) — Bridge from existing USDC to pathUSD on Tempo clawcard agent wallet send --to <0x address> --amount --json Send USDC to any address on Base. Requires ETH for gas. clawcard agent wallet send --url --json Pay an x402 API. Gasless. Cost set by the API. clawcard agent wallet send --url --protocol mpp --json Pay an MPP API. Uses pathUSD on Tempo. clawcard agent wallet send --url --method POST --body '{"key":"value"}' --json Pay an API with a POST request and JSON body. clawcard agent wallet transactions --json Transaction history. Each entry includes protocol (x402, mpp, bridge, direct) and txHash. x402/direct → https://basescan.org/tx/ mpp/bridge → https://explore.tempo.xyz/receipt/ clawcard agent wallet freeze --json Freeze wallet — blocks all sends. clawcard agent wallet unfreeze --json Unfreeze wallet. clawcard agent wallet close --json Close wallet permanently. ### Credentials clawcard agent creds --json List stored credentials (names only). clawcard agent creds set --service --key --value --json Store credential. Use lowercase naming: service=openai, key=api_key. clawcard agent creds get --service --key --json Retrieve credential value. ### Budget clawcard agent budget --json Check remaining budget for card spending. ### Activity clawcard agent activity --json [--limit 50] Full audit trail of every action. --- ## Typical flow 1. Human runs: clawcard signup (or clawcard login) 2. Human runs: clawcard billing topup (minimum $5) 3. Human runs: clawcard keys create 4. Human runs: clawcard setup (installs skill, configures API key) 5. Agent runs: clawcard agent info --json (discover identity) 6. Agent runs: clawcard agent budget --json (check budget) 7. Agent runs: clawcard agent cards --json (list existing cards) 8. Agent runs: clawcard agent cards create --amount 2000 --type single_use --memo "Domain" --json 9. Agent uses PAN, CVV, expiry to pay for something online 10. single_use cards auto-close after one charge; merchant_locked cards stay open ## Wallet flow (for API payments) 1. Agent runs: clawcard agent wallet --json (check or create wallet) 2. Human runs: clawcard agent wallet fund (fund with ETH, USDC, and/or pathUSD) 3. Agent runs: clawcard agent wallet balance --json (verify balances) 4. Agent runs: clawcard agent discover --query "search" --json (find x402 APIs) 5. Agent runs: clawcard agent wallet send --url "" --json (pay x402 API) 6. For MPP APIs: clawcard agent wallet send --url "" --protocol mpp --json ## Tips - Always run clawcard agent info --json first to verify identity. - Check budget before creating cards. - Reuse merchant_locked cards for repeat purchases at the same merchant. - Use single_use cards for one-time purchases — they auto-close. - Store secrets in the credentials vault, not in plaintext. - For x402 payments: wallet needs USDC + a small amount of ETH for gas. - For MPP payments: wallet needs pathUSD (bridge from USDC via fund wizard). - MPP/bridge transactions use the Tempo explorer; x402/direct use Basescan. ## Links Website: https://clawcard.sh Docs: https://clawcard.sh/docs npm: https://www.npmjs.com/package/@clawcard/cli Skill: npx skills add latchagent/skill