Gadgethumans X402 MCP Server

@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