支付中间件服务

Agent HTTP Request → MCPay 402 → OWS Signs USDC → On-Chain Verified → Tool Executes

graph TD
    subgraph "🤖 AI Agent — Buyer"
    A["👤 User Prompt"] -->|Query| B["🤖 Claude via AIML API"]
    B -->|Tool Call| C["🛡️ mcpay SDK — x402 Interceptor"]
    end

    subgraph "💸 OWS Payment Rails"
    C -->|HTTP 402 Required| D["🔑 OWS CLI — Wallet Engine"]
    D -->|Evaluate Spend Policy| D1["📜 OWS Policy — maxPrice · chain allowlist"]
    D1 -->|EIP-155 Sign & Broadcast| E["🏦 Base Sepolia — USDC Settlement"]
    end

    subgraph "📦 Tool Server — Seller"
    E -->|On-chain Proof| F["📡 demo-tool-server"]
    F -->|x402 Verified| G["✅ Tool Executes & Returns Result"]
    end

    subgraph "📊 Live Monitoring"
    F -->|Payment Event| H["✉️ XMTP — Wallet-to-Wallet Alert"]
    F -->|Earnings Sync| I["◉ Zerion API — Real On-Chain Balance"]
    I --> J["📟 Registry UI — Next.js Dashboard"]
    H --> J
    end

MCPAY/
├── packages/
│   ├── mcpay-middleware/     ← npm package (@nikhilraikwar/mcpay)
│   │   └── src/index.ts      x402 enforcement · stats · onPayment callback · mcpayFetch()
│   │
│   ├── demo-tool-server/     ← Express server with 3 live x402-gated tools
│   │   ├── server.ts         weather-data · url-summarizer · check-portfolio
│   │   ├── xmtp-notifier.ts  Real-time wallet-to-wallet XMTP payment alerts
│   │   └── zerion.ts         Live on-chain portfolio tracking via Zerion API
│   │
│   ├── agent-client/         ← Autonomous Claude agent
│   │   └── agent.ts          Plan → OWS Pay → Execute loop via AIML API
│   │
│   └── registry-ui/          ← Next.js 14 dashboard
│       └── app/
│           ├── page.tsx      Landing page with full documentation
│           └── dashboard/    AI Playground · Live Feed · XMTP Inbox · Zerion · Policy

import { mcpay, mcpayFetch, getStats } from '@nikhilraikwar/mcpay'

// SERVER: Wrap any route with x402 payment enforcement
app.use(...mcpay({
  price: '$0.01',                          // Fixed price per call
  walletAddress: '0xYourWallet',           // Your OWS tool wallet
  toolName: 'weather-data',
  description: 'Real-time weather data',
  onPayment: async (stats) => {
    // Fires after every successful settlement
    // Used for XMTP alerts, DB updates, webhooks
    console.log(`Earned ${stats.totalEarned} USDC total`)
  }
}))

// Dynamic pricing per AI model — covers Track 04 simultaneously
app.use(...mcpay({
  price: (req) => MODEL_PRICES[req.body.model] ?? '$0.01',
  toolName: 'ai-inference',
}))

// CLIENT: Agent-side fetch with automatic 402 → OWS payment → retry
const result = await mcpayFetch('http://localhost:3001/tools/weather-data', {
  method: 'POST',
  body: JSON.stringify({ city: 'Delhi' }),
  owsWallet: 'mcpay-agent',  // OWS CLI wallet name
  maxPrice: '$0.05'           // OWS policy ceiling
})
// → { city: 'Delhi', temperature: '38°C', _mcpay: { paid: '$0.01' } }

# 1. Clone and install
git clone https://github.com/NikhilRaikwar/MCPay.git
cd MCPay && npm install

# 2. Configure environment
cp .env.example .env
# Fill in: ANTHROPIC_API_KEY, TOOL_WALLET_ADDRESS, ZERION_API_KEY, XMTP_PRIVATE_KEY

# 3. Setup OWS wallets
bash setup.sh

# 4. Start tool server (Terminal 1)
npm run dev --workspace=demo-tool-server

# 5. Start dashboard (Terminal 2)
npm run dev --workspace=registry-ui

# 6. Run agent (Terminal 3)
npm run start --workspace=agent-client "What's the weather in Delhi?"