Give Your AI Agent a Wallet

Self-custodial USDC payments for Claude, Cursor, and any MCP client. Zero config. One line to install.

Terminal
$
Quick Install

One command. Works everywhere.

claude mcp add x402-wallet -- npx x402-wallet-mcp@latest
{
  "mcpServers": {
    "x402-wallet": {
      "command": "npx",
      "args": ["x402-wallet-mcp@latest"]
    }
  }
}

Add to .cursor/mcp.json or .windsurf/mcp.json in your project root.

{
  "mcpServers": {
    "x402-wallet": {
      "command": "npx",
      "args": ["x402-wallet-mcp@latest"]
    }
  }
}

Add to Settings → Developer → MCP Servers

Why x402-wallet?

Everything your agent needs to pay for APIs, built in.

Coinbase

Fund Your Agent in Seconds

Just ask Claude to fund your wallet. Buy USDC with a debit card or Apple Pay via Coinbase — zero fees on Base. No exchange account needed. Your agent handles everything.

Works out of the box. No API keys required.

Recover on Any Device

Link your wallet to email once. Recover it on any device — Claude Code, Claude Desktop, Cursor — with a single verification code. Switch machines without losing funds.

Your wallet follows you, not your machine.

Enterprise-Grade Key Security

No private key is ever stored on your machine. All keys live in Privy's HSM/TEE secure enclaves — hardware that never exposes raw key material. No seed phrases, no browser extensions, no risk of clipboard theft.

If this service disappears, export your key at home.privy.io. Your funds are always yours.
Powered by Privy
Features

Everything you'd expect from a wallet, nothing you wouldn't.

Zero Config

No API keys, no signup, no seed phrases. Install and go.

Self-Custodial

Your keys, your funds. Export your private key at home.privy.io anytime.

Spending Controls

Per-call max + daily cap. Your agent can't overspend.

Merchant Allowlist

Whitelist trusted payment addresses only.

Gasless Payments

EIP-3009 signatures — no ETH needed for gas.

13 MCP Tools

Discover, query, pay, audit — everything an agent needs.

How It Works

Four steps, fully automatic.

1

Agent calls a paid API

Any x402-enabled endpoint

→
2

Server returns HTTP 402

With price & payment details

→
3

Wallet signs USDC payment

EIP-3009 — gasless

→
4

Retries with payment

Gets data instantly

13 Tools

Everything your agent can do with its wallet.

call_endpoint
Make a paid API call (handles full 402 flow)
url, method?, body?, headers?
query_endpoint
Probe pricing without paying
url, method?
discover_endpoints
Search for available x402 APIs
query?, source?
check_balance
USDC balance on Base + deposit address
wallet_info
Wallet mode, addresses, recovery status
fund_wallet
Buy USDC via Coinbase Onramp
amount?
transaction_history
Recent payment log
limit?
configure_spending
Set per-call max and daily cap
per_call_max?, daily_cap?
add_endpoint_source
Register a .well-known/x402 source
base_url?, endpoint_url?
manage_allowlist
Add/remove merchant allowlist entries
allow?, remove?, mode?
wallet_link
Link wallet to email for recovery
email?, code?
wallet_recover
Recover a linked wallet on any device
email?, code?, wallet_id?
export_key
Instructions for exporting private key via Privy

Are You an Agent?

If you're an AI reading this, here's what you need:

Install: claude mcp add x402-wallet -- npx x402-wallet-mcp@latest

npm: npmjs.com/package/x402-wallet-mcp

GitHub: github.com/onchainexpat/x402-wallet-mcp

Discovery: x402.onchainexpat.com/.well-known/x402