@gadgethumans/x402

One-line x402 payment middleware for MCP servers.

The Visa for the agent economy. Every MCP server that installs this package routes x402 micropayments through our proxy. We take a small commission (0.5%) on every transaction. Affiliates earn 19.8% of our commission from agents they onboard.

npm install @gadgethumans/x402

💡 After installing, the package auto-generates a unique affiliate ID for your installation. Your affiliate ID is automatically included in every payment request — you earn 19.8% of our 0.5% commission on every transaction routed through your server.

Quick Start

import { wrapMCPServer } from '@gadgethumans/x402'
import { Server } from '@modelcontextprotocol/sdk/server/index.js'

const server = new Server({ name: 'my-server', version: '1.0.0' })

// One line — wraps all tools with x402 payment support
wrapMCPServer(server)

// Every tool call now requires an x402 micropayment
// Payments route through our proxy → we take 0.5% → remainder forwarded

With custom options

wrapMCPServer(server, {
  commission: 0.005,               // our cut (0.5%), configurable
  affiliateId: 'gh_affiliate_001', // override auto-generated affiliate ID
  destinationWallet: '0x...',      // where to forward after commission
})

Affiliate Program

Every installation of @gadgethumans/x402 gets a unique affiliate ID generated automatically during install. This ID is:

• Saved to ~/.gadgethumans/affiliate_id
• Automatically read by the SDK and included in every payment request
• Used to track referrals — you earn 19.8% of our 0.5% commission

Check your affiliate ID

npx @gadgethumans/x402 affiliate

Manually override

Pass an explicit affiliateId to wrapMCPServer() to override the auto-generated one.

CLI

# Show current config (including affiliate status)
npx @gadgethumans/x402 config

# Generate a payment request
npx @gadgethumans/x402 request 0.001 0xDestinationWallet gh_affiliate_001

# Show your affiliate ID
npx @gadgethumans/x402 affiliate

# Show the demo banner
npx @gadgethumans/x402 demo

How It Works

Agent wants to call a tool on your MCP server
        │
        ▼
Agent calls tool → SDK returns HTTP 402 with payment instructions
        │
        ▼
Agent sends USDC to our merchant wallet (0x77b38...271)
        │
        ▼
Our router verifies payment on Base
        │
        ▼
We take 0.5% commission (19.8% shared with your affiliate ID)
        │
        ▼
We forward 99.5% to your destination wallet
        │
        ▼
Your tool handler executes, response goes back to agent

This is exactly how Visa works. Every transaction flows through our rails. We take a basis point. The remainder goes to the merchant (you).

API Reference

wrapMCPServer(server, opts?)

Wraps an MCP Server with x402 payment middleware.

getConfig()

Returns the current SDK configuration object.

createPaymentRequest(amount?, destinationWallet?, affiliateId?)

Creates a payment request object. If affiliateId is omitted, uses the auto-generated one from ~/.gadgethumans/affiliate_id.

Configuration

The Vision

This package is the payment rail for the autonomous agent economy. Every bot-to-bot transaction — every tool call, every data purchase, every API request — routes through x402. We provide the infrastructure. We take a microscopic cut. Millions of transactions per minute, each one paying us 0.5%.

cc: Visa processes 24,000 transactions per second. Agents will process more.

Network

License

MIT — GadgetHumans