x402 — Claude Code Plugin

A Claude Code plugin for implementing the x402 open payment standard with Cloudflare Workers, Agents, and MCP servers.

x402 enables services to charge for API and content access directly over HTTP using the 402 Payment Required status code — no accounts, sessions, or credential management needed.

Install

claude plugin install x402

Or from this repo directly:

claude --plugin-dir ./x402-claude-plugin

Usage

Once installed, use the /x402 slash command:

The skill also activates automatically when Claude detects you're working on payment-related endpoints, HTTP 402 flows, or paid MCP tools.

What it covers

• Paywalled endpoints — x402-hono middleware to gate routes with crypto payments
• Paying agents — x402-fetch wrapper so agents automatically pay 402 responses
• Paid MCP servers — agents/x402 withX402 + paidTool registration
• Paying MCP clients — agents/x402 withX402Client with human-in-the-loop confirmation
• Combined patterns — full Worker + Agent setups with both server and client
• Environment setup — wrangler secrets, .dev.vars, Durable Object bindings
• Testnet/mainnet — base-sepolia for testing, base for production

Dependencies it knows about

x402-hono          — Hono payment middleware
x402-fetch         — fetch wrapper with auto-payment
agents             — Cloudflare Agents SDK
@modelcontextprotocol/sdk — MCP server/client SDK
viem               — Ethereum account/signing
zod                — Schema validation for MCP tools
hono               — HTTP framework

Move Registry

This plugin is also published on the Sui Move Registry at x402.sui.

See MOVE_REGISTRY.md for on-chain registration details.

Links

• x402 standard
• Cloudflare Agents x402 docs
• Worker + Agent example
• MCP paid tools example
• Facilitator docs
• Test faucet (base-sepolia)

License

MIT