Table of Contents
AI agents that need to hold, send, trade, and pay USDC need a wallet bootstrap, not just an HTTP payment wrapper. Coinbase's Agentic Wallet is that path: the awal CLI (plus an MCP option) authenticates via email OTP, keeps keys in Coinbase TEE infrastructure, and exposes balance, send, trade, and x402 commands.
This guide walks the 2026 Agentic Wallet stack as of September 13, 2026: CLI vs MCP, Node 24+ install, email OTP auth, core awal commands and chains, x402 bazaar/pay, security guardrails (session caps, tx limits, enclave isolation, KYT), and how this differs from AgentKit.
Key Takeaways
- Coinbase Agentic Wallet gives an agent a USDC wallet via awal CLI skills or payments-mcp; keys stay in Coinbase TEE infra, not in the LLM prompt.
- Install with npx skills add coinbase/agentic-wallet-skills on Node.js 24+; auth is email OTP (awal auth login then awal auth verify).
- Balance/send support base (default), base-sepolia, solana, solana-devnet, polygon; trading is Base mainnet only.
- x402 path: awal x402 bazaar search and awal x402 pay; Coinbase's Feb 11, 2026 launch cites 50M+ battle-tested x402 txs.
- Named downside: MCP discover/pay only (no send/trade); session caps and KYT can block; this is not the AgentKit fetch wrapper.
What Coinbase Agentic Wallet is (and isn't)
On February 11, 2026, Coinbase launched Agentic Wallets as wallet infrastructure built for autonomous agents. The product gives agents tools to hold, spend, trade, and earn stablecoins with built-in security guardrails.
There are two integration paths in Coinbase's Agentic Wallet overview:
| Path | Integration | Best for | Send & trade | x402 |
|---|---|---|---|---|
| Agentic Wallet CLI (awal) | Skills library + npx awal commands | Developers building agents in code | Yes | Yes |
| Agentic Wallet MCP | npx @coinbase/payments-mcp | MCP-compatible clients (Claude, Codex, Gemini) | No (discover/pay only) | Yes |
Agentic Wallet is not the same as Coinbase AgentKit / CdpX402Client. AgentKit is the buyer-side fetch/pay wrapper for an x402 API call. Agentic Wallet is the wallet the agent lives in day to day.
For the buyer-side first paid call, see how to pay for an x402 API with Coinbase AgentKit.
Prerequisites (as of Sep 13, 2026)
Coinbase's CLI quickstart requires:
- Node.js 24+
- An email address for wallet authentication
- The skills package: npx skills add coinbase/agentic-wallet-skills
That install pulls the agent skills library built on top of Vercel AI SDK skills and exposes the awal CLI.
Step 1. Authenticate with email OTP
Authentication is initiate, then verify.
1. Initiate login
Run npx awal auth login user@example.com. Coinbase's docs show a verification code sent to that email and a flowId printed in the terminal.
2. Verify OTP
Run npx awal auth verify <flowId> <otp>. Pass the flowId from step 1 and the 6-digit code from email. Success prints authenticated status for that email.
3. Confirm with status
Run npx awal status. You should see the wallet server running and the authenticated email. All commands also support --json for machine-readable agent loops.
Step 2. Address, balance, send, and trade USDC
Once authenticated:
| Command | Purpose |
|---|---|
| npx awal status | Server health and auth status |
| npx awal address | Wallet address |
| npx awal balance [--chain] | USDC balance |
| npx awal send | Send USDC to an address or ENS |
| npx awal trade | Trade tokens on Base |
| npx awal show | Open the wallet companion window |
| npx awal quit | Stop the background wallet server |
| npx awal telemetry enable|disable | Anonymous usage telemetry |
| npx awal persistence enable|disable | Keep session active between runs |
Chains for balance/send: base (default), base-sepolia, solana, solana-devnet, polygon. Trading is Base mainnet only.
Examples Coinbase documents include npx awal balance, npx awal balance --chain solana, npx awal send 1 vitalik.eth, and npx awal trade 5 usdc eth.
Fund the address before the first send. For treasury ops patterns, see how to fund an AI agent wallet with USDC.
Step 3. Pay for x402 services from the wallet
Agentic Wallet CLI includes x402 discovery and payment: npx awal x402 bazaar search <query> and npx awal x402 pay <url>.
Coinbase's Feb 11, 2026 launch page frames x402 as battle-tested with over 50 million transactions. Treat that as protocol-scale history, not your agent's monthly volume.
Seller-side accept patterns live in how to accept x402 USDC payments from AI agents. Circle nanopayments are a different stack: how to make a Circle agent nanopayment in USDC.
Step 4. MCP path (discover and pay only)
If the agent runs inside an MCP-compatible client and only needs discover/pay, run npx @coinbase/payments-mcp.
Per Coinbase's overview table, MCP agents discover and pay for services only. They do not get send or trade. Use the CLI when the agent must move USDC or trade on Base.
Security guardrails that matter for USDC agents
Coinbase documents programmable guardrails on Agentic Wallets:
- Session caps: maximum spend per session
- Transaction limits: control individual transaction sizes
- Enclave isolation: private keys remain in secure Coinbase infrastructure (TEE); keys are not exposed to the agent's prompt or LLM
- KYT screening: built-in Know Your Transaction screening that can block high-risk interactions
That means a compromised prompt cannot print the private key, and a runaway loop can still hit a session cap or KYT refusal. Set caps before funding production balances.
For a broader wallet setup checklist, see how to set up an AI agent wallet.
Stablecoin Insider's take
FAQ
How do I create a Coinbase Agentic Wallet for USDC?
Install with npx skills add coinbase/agentic-wallet-skills on Node.js 24+, run npx awal auth login then npx awal auth verify with the email OTP, then use address, balance, send, trade, and x402 commands.
What is the difference between Agentic Wallet and AgentKit?
Agentic Wallet is the wallet bootstrap (hold/send/trade/pay). AgentKit / CdpX402Client is the buyer-side x402 fetch/pay wrapper for a protected API call.
Which chains does awal support for balance and send?
base (default), base-sepolia, solana, solana-devnet, and polygon. Trading is Base mainnet only.
Can the MCP path send USDC?
No. Coinbase documents Agentic Wallet MCP as discover and pay only. Use the CLI for send and trade.
Where are the private keys?
In Coinbase TEE / enclave infrastructure. Keys are not exposed to the LLM prompt. Session caps, tx limits, and KYT still apply before a signature.
Is x402 required to use Agentic Wallet?
No. You can authenticate, check balances, send, and trade without x402. x402 bazaar/search and pay are optional machine-to-machine payment tools on the same wallet.
Next step
Run npx skills add coinbase/agentic-wallet-skills on Node 24+, complete email OTP auth, confirm npx awal status, then fund a small Base USDC balance and set session caps before any unattended agent loop. Keep AgentKit for the typed x402 fetch path when you need it.
Read Coinbase's Agentic Wallet CLI quickstart, then compare the AgentKit buyer path when you need a typed x402 fetch.
This content is provided for informational and educational purposes only and does not constitute financial, investment, legal, or tax advice; no material herein should be interpreted as a recommendation, endorsement, or solicitation to buy or sell any financial instrument, and readers should conduct their own independent research or consult a qualified professional.
){kind=link}