x402 Wallet Setup

x402 lets AI agents pay per request with USDC on Base — no accounts, no sign-up, no monthly commitment. This guide walks you through setting up a wallet for your agent.

Already have an x402 wallet? Skip to Making your first paid request.

What is x402?

x402 is an open payment standard built on HTTP. When your agent requests a protected resource, the server responds with 402 Payment Required and a price. Your agent signs a USDC payment and retries — the whole flow happens in the request/response cycle, no separate checkout.

Feature	x402	Traditional API keys
Account required	❌ No	✅ Yes
Signup flow	❌ None	✅ Email + billing
Payment method	USDC on Base	Credit card
Per-request billing	✅ Automatic	⚠️ Prepaid credits
Agent-native	✅ Built for agents	⚠️ Designed for humans

Choose your setup path

Pick the path that matches your agent platform:

Agentic Wallet MCP

For Claude Desktop, Claude Code, Cursor, Codex CLI, Gemini CLI, or any MCP client. Easiest path.

Agentic Wallet CLI

For agents that can run shell commands but don’t speak MCP. Fastest setup.

CDP SDK

For custom Python or TypeScript agents. Most control.

OpenClaw

For OpenClaw agents with existing x402 support.

Agentic Wallet MCP

Best for: Claude Desktop, Claude Code, Cursor, Codex CLI, Gemini CLI, and any MCP-compatible client. Setup time: ~5 minutes

1. Install the MCP server

npx @coinbase/payments-mcp

The installer will prompt you to select your MCP client and configure it automatically.

2. Restart your client

Close and reopen your MCP client to load the wallet tools.

3. Sign into your wallet

Ask your agent:

Show me my wallet

This opens a browser window for authentication:

New users: Enter your email → verify your email → wallet created
Returning users: Enter your email → verify your email → you’re in

4. Fund your wallet

In the wallet UI:

Click Fund
Follow the Coinbase Onramp flow to add USDC
Return to your agent

Or:

Click Receive
Copy your wallet address
Send USDC on Base to that address

How much to fund? At

0.005/request,

1 USDC covers 200 scrapes. Start with $5 for 1,000 requests.

5. Set spending limits (recommended)

In the wallet UI:

Click the spending limit tracker
Set Max per call: e.g., $0.05
Set Max per session: e.g., $5.00
Save

Your agent respects these limits but can’t change them — only you can.

6. Make your first paid request

Ask your agent:

Scrape https://example.com using X1-BaaS

Or search for X1-BaaS in the Bazaar:

What x402 services are available for web scraping?

Agentic Wallet CLI

Best for: Agents that can run shell commands, CI pipelines, terminal-based workflows. Setup time: ~2 minutes

1. Install and authenticate

# Send OTP to your email
npx awal auth login your@email.com

# Verify with the 6-digit code
npx awal auth verify <flowId> <otp>

# Confirm authentication
npx awal status

2. Get your wallet address

npx awal address

Send USDC on Base to this address.

3. Check your balance

npx awal balance

4. Make a paid request

npx awal x402 pay https://api.tazpal.com/v1/scrape \
  -X POST \
  -H "Content-Type: application/json" \
  -d '{"url": "https://example.com"}'

CLI Reference

Command	Purpose
`npx awal status`	Check auth status
`npx awal balance`	Check USDC balance
`npx awal address`	Get wallet address
`npx awal send <amount> <recipient>`	Send USDC
`npx awal x402 bazaar search <query>`	Discover services
`npx awal x402 pay <url>`	Make paid request

CDP SDK

Best for: Custom Python or TypeScript agents, applications with their own payment logic. Setup time: ~15 minutes

Prerequisites

Create a free account at portal.cdp.coinbase.com
Generate an API key and wallet secret
Set environment variables:

export CDP_API_KEY_ID="your-api-key-id"
export CDP_API_KEY_SECRET="your-api-key-secret"
export CDP_WALLET_SECRET="your-wallet-secret"

TypeScript

npm install @coinbase/cdp-sdk @x402/core @x402/evm @x402/fetch

import { CdpX402Client } from "@coinbase/cdp-sdk/x402";
import { wrapFetchWithPayment } from "@x402/fetch";

const client = new CdpX402Client();
const { evmAddress } = await client.getAddresses();
console.log(`Paying from ${evmAddress}`);

const fetchWithPayment = wrapFetchWithPayment(globalThis.fetch, client);
const response = await fetchWithPayment("https://api.tazpal.com/v1/scrape", {
  method: "POST",
  headers: { "Content-Type": "application/json" },
  body: JSON.stringify({ url: "https://example.com" }),
});

console.log(`HTTP ${response.status}`);

Python

pip install "cdp-sdk" "x402[evm,httpx]"

import asyncio
from cdp import CdpClient
from cdp.evm_local_account import EvmLocalAccount
from x402 import x402Client
from x402.http.clients import x402HttpxClient
from x402.mechanisms.evm import EthAccountSigner
from x402.mechanisms.evm.exact import ExactEvmScheme

async def main():
    async with CdpClient() as cdp:
        account = await cdp.evm.get_or_create_account(name="baas-client")
        signer = EthAccountSigner(EvmLocalAccount(account))
        print(f"Paying from {signer.address}")

        payment_client = x402Client()
        payment_client.register("eip155:8453", ExactEvmScheme(signer))

        async with x402HttpxClient(payment_client) as http:
            response = await http.post(
                "https://api.tazpal.com/v1/scrape",
                json={"url": "https://example.com"},
            )
            print(f"HTTP {response.status_code}")

asyncio.run(main())

Fund the wallet

The wallet address is printed when you run the client. Send USDC on Base to that address. For testing, use Base Sepolia testnet and the CDP Faucet.

OpenClaw

OpenClaw agents with x402 support can use X1-BaaS directly. The MCP server handles payment automatically.

MCP Configuration

Add to your OpenClaw MCP configuration:

{
  "x1-baas": {
    "url": "https://api.tazpal.com/mcp",
    "transport": "streamable-http"
  }
}

Using the scrape tool

Once configured, your agent can call the scrape tool directly. If x402 payment is required, the agent will handle the payment flow automatically (if it has an x402 wallet configured).

Hermes Agent

Hermes Agent by Nous Research supports MCP servers natively via ~/.hermes/config.yaml.

MCP Configuration

Add to ~/.hermes/config.yaml:

mcp_servers:
  x1-baas:
    url: https://api.tazpal.com/mcp
    transport: streamable-http

Or use the interactive MCP picker:

hermes mcp

Setting up x402 payments

Hermes Agent can use the Agentic Wallet MCP for x402 payments:

npx @coinbase/payments-mcp

Select “Other” when prompted for your client, then add the MCP server to your Hermes config:

mcp_servers:
  x1-baas:
    url: https://api.tazpal.com/mcp
    transport: streamable-http
  payments:
    command: "npx"
    args: ["@coinbase/payments-mcp"]

Alternatively, use the CLI path with npx awal (see Agentic Wallet CLI above).

Using the scrape tool

Once configured, ask Hermes to scrape a page:

Scrape https://news.ycombinator.com using X1-BaaS

Hermes will discover the MCP tools and use them automatically.

Making your first paid request

Once your wallet is set up and funded:

Via MCP (any client)

Scrape https://news.ycombinator.com using X1-BaaS

Via curl

curl -X POST https://api.tazpal.com/v1/scrape \
  -H "Content-Type: application/json" \
  -H "X-PAYMENT: <base64-encoded-payment>" \
  -d '{"url": "https://news.ycombinator.com"}'

Via the BaaS API directly

The x402 flow is automatic when using the CDP SDK or Agentic Wallet:

Agent requests /v1/scrape with no payment
Server responds 402 Payment Required with price and payment options
Agent signs a USDC permit and retries with X-PAYMENT header
Server verifies payment, scrapes the page, returns clean Markdown

You’re only charged on success. Payment is verified before the scrape and settled only after a successful result. Timeouts and connection failures never charge you.

Troubleshooting

”402 Payment Required” on every request

Your wallet doesn’t have enough USDC. Check your balance:

MCP: Ask “What’s my wallet balance?”
CLI: npx awal balance
SDK: Check the wallet address and verify on BaseScan

”Authentication failed” after setting up wallet

Your payment may have expired. x402 payments have a time window — if your agent takes too long between signing and sending, the payment expires. This is normal; just retry.

Wallet not showing up

Make sure you:

Completed email verification
Restarted your MCP client after installation
Asked your agent to “Show me my wallet” (this triggers the auth flow)

Can I use testnet?

Yes. For development:

CDP SDK: Pass environment: "development" to use Base Sepolia
Get test USDC from the CDP Faucet
X1-BaaS testnet endpoint: https://api-testnet.tazpal.com (coming soon)

Security Best Practices

Set spending limits — Always configure max per-call and per-session limits in the wallet UI
Use separate wallets — Don’t reuse your main crypto wallet for agent payments
Monitor usage — Check your wallet balance and transaction history regularly
Start small — Fund with $5-10 USDC initially, increase as needed
Use testnet first — Test your integration on Base Sepolia before mainnet

Authentication

API keys vs x402 — choose the right path for your use case.

Scrape endpoint

Full API reference for the scrape endpoint.

x402 Protocol

Learn how x402 payments work under the hood.

Agentic Wallet Docs

Official Coinbase Agentic Wallet documentation.

​x402 Wallet Setup

​What is x402?

​Choose your setup path

Agentic Wallet MCP

Agentic Wallet CLI

CDP SDK

OpenClaw

​Agentic Wallet MCP

​1. Install the MCP server

​2. Restart your client

​3. Sign into your wallet

​4. Fund your wallet

​5. Set spending limits (recommended)

​6. Make your first paid request

​Agentic Wallet CLI

​1. Install and authenticate

​2. Get your wallet address

​3. Check your balance

​4. Make a paid request

​CLI Reference

​CDP SDK

​Prerequisites

​TypeScript

​Python

​Fund the wallet

​OpenClaw

​MCP Configuration

​Using the scrape tool

​Hermes Agent

​MCP Configuration

​Setting up x402 payments

​Using the scrape tool

​Making your first paid request

​Via MCP (any client)

​Via curl

​Via the BaaS API directly

​Troubleshooting

​”402 Payment Required” on every request

​”Authentication failed” after setting up wallet

​Wallet not showing up

​Can I use testnet?

​Security Best Practices

​What to read next

Authentication

Scrape endpoint

x402 Protocol

Agentic Wallet Docs

x402 Wallet Setup

What is x402?

Choose your setup path

Agentic Wallet MCP

1. Install the MCP server

2. Restart your client

3. Sign into your wallet

4. Fund your wallet

5. Set spending limits (recommended)

6. Make your first paid request

Agentic Wallet CLI

1. Install and authenticate

2. Get your wallet address

3. Check your balance

4. Make a paid request

CLI Reference

CDP SDK

Prerequisites

TypeScript

Python

Fund the wallet

OpenClaw

MCP Configuration

Using the scrape tool

Hermes Agent

MCP Configuration

Setting up x402 payments

Using the scrape tool

Making your first paid request

Via MCP (any client)

Via curl

Via the BaaS API directly

Troubleshooting

”402 Payment Required” on every request

”Authentication failed” after setting up wallet

Wallet not showing up

Can I use testnet?

Security Best Practices

What to read next