Paying Meterlane Routes with Coinbase Agentic Wallet

Coinbase Agentic Wallet gives AI agents a managed wallet they can use to pay x402 APIs without you building wallet infrastructure from scratch. Meterlane’s public sandbox demo route is a ready-made target you can use to validate the buyer side of your integration — no account or signup required to test.

All examples on this page target Base Sepolia (eip155:84532). The public x402.org facilitator does not support Base mainnet. Use sandbox keys and test USDC only.

Public sandbox demo URL

https://gateway.meterlane.app/gateway/demo/demo

An unpaid request returns HTTP 402 with an X-Payment-Requirements header. A funded agent wallet receives HTTP 200 and the response body from the upstream demo API. Confirm the route is live before testing your wallet integration:

curl -i https://gateway.meterlane.app/gateway/demo/demo

Option A — awal CLI

The awal CLI is the fastest way to pay a Meterlane route from a terminal or an agent workflow that calls shell commands.

Add Agentic Wallet skills

Run this once to install the Coinbase Agentic Wallet skill set:

npx skills add coinbase/agentic-wallet-skills

Open the Agentic Wallet UI after sign-in and deposit test USDC on Base Sepolia via Coinbase Onramp or the Circle faucet at faucet.circle.com.Set spending limits in the wallet UI before running any autonomous agent loops.

Inspect payment requirements (no charge)

Check the price and payment details for the demo route without spending any USDC:

npx awal@latest x402 details https://gateway.meterlane.app/gateway/demo/demo

Pay and fetch the route

Execute the paid request:

npx awal@latest x402 pay https://gateway.meterlane.app/gateway/demo/demo

A successful payment prints the 200 response body to stdout.

Option B — payments-mcp (AI assistants)

@coinbase/payments-mcp runs a local MCP server that exposes a make_x402_request tool. Any MCP-compatible AI assistant — Claude Desktop, Claude Code, Codex, Gemini CLI, and others — can call it to pay x402 routes without custom code.

Start the MCP server

npx @coinbase/payments-mcp

Add it to your MCP client config

For Claude Desktop, add the following to your claude_desktop_config.json:

{
  "mcpServers": {
    "coinbase-payments": {
      "command": "npx",
      "args": ["-y", "@coinbase/payments-mcp"]
    }
  }
}

Restart the client after editing the config.

Complete the wallet sign-in flow that appears after restart, then deposit test USDC on Base Sepolia.

Ask your assistant to pay the demo route

Prompt your assistant naturally:

Pay for this x402 API and return the response body:
GET https://gateway.meterlane.app/gateway/demo/demo

The MCP make_x402_request tool handles 402 → pay → retry automatically and returns the 200 body to the assistant.

Option C — `@meterlane/x402` createAgentClient (scripted / CI)

If you are writing TypeScript or running automated tests, use createAgentClient from @meterlane/x402/client directly. This gives you full programmatic control and is the right choice for CI pipelines and custom agent frameworks.

Never commit private keys to version control. Load them from environment variables and use a dedicated hot wallet with a limited USDC balance.

import type { Hex } from "viem";
import { createAgentClient } from "@meterlane/x402/client";

const privateKey = process.env.AGENT_PRIVATE_KEY as Hex;
const paidFetch = createAgentClient(privateKey, "eip155:84532");

const res = await paidFetch(
  "https://gateway.meterlane.app/gateway/demo/demo",
  { method: "GET" }
);

console.log(res.status);       // 200 after successful payment
console.log(await res.text()); // upstream response body

See the SDK reference for full createAgentClient documentation, including the onSettled callback and network options.

Choosing the right tool

Tool	Best for	Requires code?
`npx awal@latest x402 pay`	Terminal commands, agent skills workflows	No
`npx @coinbase/payments-mcp`	Claude Desktop, Claude Code, Codex, Gemini CLI	No
`createAgentClient` from `@meterlane/x402/client`	TypeScript apps, CI pipelines, custom agent frameworks	Yes

All three options use the same x402 payment protocol and settle on Base Sepolia for sandbox demos. For production routes on Base mainnet, configure a private mainnet-capable facilitator in your Meterlane dashboard under Settings → Developer.

SDK Reference

Full createAgentClient and createCKMiddleware API docs

LangChain Integration

Wrap a gateway route as a DynamicStructuredTool

Get Started

Agent Gateway

Stablecoin Corridor

Integrations

Account & Billing

Paying Meterlane Routes with Coinbase Agentic Wallet

Public sandbox demo URL

Option A — awal CLI

Option B — payments-mcp (AI assistants)

Option C — `@meterlane/x402` createAgentClient (scripted / CI)

Choosing the right tool

SDK Reference

LangChain Integration

​Public sandbox demo URL

​Option A — awal CLI

​Option B — payments-mcp (AI assistants)

​Option C — @meterlane/x402 createAgentClient (scripted / CI)

​Choosing the right tool

SDK Reference

LangChain Integration

Public sandbox demo URL

Option A — awal CLI

Option B — payments-mcp (AI assistants)

Option C — `@meterlane/x402` createAgentClient (scripted / CI)

Choosing the right tool