Introduction

MCP-native integration layer enabling AI agents to execute autonomous transactions on the x402 protocol.

What is Claw402?

Claw402 is a Model Context Protocol (MCP) server that enables AI agents to execute cryptocurrency transactions on the x402 protocol. By exposing x402 capabilities as callable MCP tools, Claw402 transforms autonomous agents into first-class economic actors capable of initiating, authorizing, and settling payments without human intervention.

What is x402?

x402 is an open payment protocol that leverages the HTTP 402 Payment Required status code to facilitate cryptocurrency payments through standard HTTP requests. The protocol enables:

• HTTP-native payments - Payments integrated directly into HTTP request/response flows

• Cryptographic verification - On-chain settlement with blockchain finality guarantees

• Machine-to-machine transactions - Purpose-built for autonomous agent payment operations

• Protocol-level standardization - Consistent payment semantics across implementations

• Flexible settlement - Support for micropayments to large-value transactions

Why AI Agents Need Claw402

• MCP-Native Architecture - Purpose-built Model Context Protocol server with x402 tool suite

• Declarative Transaction Semantics - Agents describe intent, Claw402 handles protocol execution

• Non-Custodial Security - Hardware-backed signing with keys isolated from agent context

• Idempotent Operations - Transaction deduplication and automatic retry on failure

• OpenClaw Integration - Drop-in Python provider for OpenClaw AI agent framework

• Protocol Specialization - x402-optimized performance unavailable in generic blockchain SDKs

Quick Start

Enable your AI agent to transact in three steps:

1. Install Claw402 MCP Server

npm install -g @claw402/mcp-server
# or
pip install claw402-mcp

2. Launch MCP Server

claw402 serve \
  --network mainnet-beta \
  --wallet ~/.config/solana/agent.json \
  --port 3402

3. Connect Your Agent

from openclaw import Agent
from claw402 import X402Provider

agent = Agent(
    name="payment_agent",
    providers=[X402Provider(port=3402)]
)

# Agent now has autonomous payment capabilities
response = agent.run("Send 0.5 SOL to [email protected]")

Documentation Structure

• Getting Started - MCP server setup and agent integration

• Concept Brief - Technical architecture and design philosophy

• MCP Tool Reference - Complete tool suite documentation

  • Payment Tools - Initialize, authorize, verify transactions

  • Query Tools - Balance queries and fee estimation

  • Streaming Updates - Real-time settlement notifications

• Authentication - Agent signing and approval policies

• Rate Limits - Transaction throughput and quota management

• Error Handling - Fault tolerance and recovery patterns

• Examples - OpenClaw and LangChain integration examples

x402 Resources

• x402 Protocol: x402.org

• x402 Documentation: x402.gitbook.io

• x402 on Twitter: @x402protocol

Support

• Documentation Issues: GitHub Issues

• Twitter: @claw402dotxyz

• Website: claw402.xyz

• Email: [email protected]