Mc Pay

MCPay——MCP工具的原生货币化层

](https://www.npmjs.com/package/@nikhilraikwar/mcpay)   

OWS 哈克马拉松 2026 ·第一个封装任何MCP工具服务器的npm中间件 x402小额支付，自主解决 OWS CLI 上 基础Sepolia.没有API密钥，没有订阅，没有帐户-只有一个OWS钱包和一个HTTP请求。

______________________________________________________________________

什么是MCPay？

MCPay是一个3线Express中间件，可以将任何MCP工具端点转换为货币化的按呼叫付费服务。代理人付款 基于Sepolia的USDC 通过x402协议。OWS CLI自主处理钱包签名和支出策略执行。每次付款都会触发 实时XMTP钱包通知 并将收益同步到 实时Zerion仪表板.

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

______________________________________________________________________

mcpay SDK

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' } }

______________________________________________________________________

实时x402工具

______________________________________________________________________

动态推理定价

MCPay将AIML API推理包装在x402后面，并采用每模型定价-OWS上的第一个逐人付费推理层：

当队列深度>10个并发请求时，浪涌定价激活。OWS支出政策强制执行最高价格上限，因此代理商永远不会多付。

______________________________________________________________________

集成

OWS+x402（核心）

代理使用OWS CLI拦截402个挑战。OWS评估支出政策（最大价格、连锁分配），并在Base Sepolia上自主签署USDC转账。每笔交易都可以在Basescan上验证。

XMTP（钱包到钱包通知）

每次结算都会通过以下方式触发钱包原生XMTP消息 @xmtp/node-sdk工具所有者会收到即时付款提醒；代理接收存储在其XMTP收件箱中的加密收据。

Zerion API（实链P&L）

仪表板显示实际赚取的USDC，而不是模拟计数器。Zerion API提取实时钱包余额、DeFi头寸和解码的交易历史记录。每一美元在链上都是可验证的。

AIML API（多模型智能）

演示代理使用Claude通过AIML API对工具调用进行推理。MCPay自动处理每个模型层的动态推理定价。代理不需要硬编码的API密钥。

______________________________________________________________________

AI游乐场

注册表仪表板具有ChatGPT风格 AI游乐场 展示了完整的机器对机器支付循环：

1. 用户询问 --“德里的天气怎么样？”
2. 代理计划 --“我需要天气数据工具（0.01美元）”
3. OWS标志 --Base Sepolia上的USDC交易广播
4. 工具响应 --仅在链上验证后返回数据
5. XMTP收据 --付款提醒已发送到工具所有者的钱包

______________________________________________________________________

本地运行

# 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?"

访问 http://localhost:3000 → AI游乐场→ 键入任何查询→ 观看完整的OWS支付流程。

______________________________________________________________________

评委演示流程

1. 打开 http://localhost:3000/dashboard → AI游乐场选项卡
2. 类型： "What's the weather in Delhi and summarize https://ows.sh"
3. 观察代理人的想法→ OWS CLI签署USDC→ 付款在Base Sepolia结算
4. 打开XMTP选项卡→ 从工具钱包收到付款收据
5. 打开Zerion选项卡→ 实时链上余额已更新

______________________________________________________________________

建于⚡ 通过 Nikhil Raikwar 参加2026年OWS黑客马拉松。\ 没有API密钥。没有订阅。只是一个钱包。