payclaw

English | 繁體中文

Middleware de pago x402 de fácil integración para servidores MCP. Cobra a agentes de IA por llamada a herramienta usando USDC en la red Base: 10 líneas de código, sin procesador de pagos, sin KYC.

El dinero fluye directamente: billetera del agente → tu billetera. payclaw nunca retiene fondos.

Inicio rápido

Python

pip install payclaw

from fastapi import FastAPI, Request
from payclaw import require_payment, PayclawConfig

app = FastAPI()
config = PayclawConfig(price_usdc=0.001, wallet_address="0xYourWallet")

@app.post("/tool")
@require_payment(config)
async def my_tool(request: Request):
    return {"result": "tool output"}

JavaScript / TypeScript

npm install payclaw-x402

import { requirePayment } from "payclaw-x402";

const gate = requirePayment({ priceUsdc: 0.001, walletAddress: "0xYourWallet" });

export default { fetch: gate.wrapFetch(async (req) => {
  return Response.json({ result: "tool output" });
})};

Related MCP server: @true402.dev/mcp-server

Cómo funciona

1. El agente llama a tu endpoint de herramienta

2. Sin un pago válido → el servidor devuelve HTTP 402 con el precio y la dirección de la billetera

3. El agente paga USDC en la red Base y obtiene el hash de la transacción

4. El agente reintenta con el encabezado X-Payment: <tx_hash>

5. payclaw verifica en la cadena → ejecuta tu herramienta

Paquetes

Endpoint en vivo: https://payclaw-mcp.vercel.app/api/mcp

Conecta con Claude Desktop:

{
  "mcpServers": {
    "payclaw": {
      "command": "npx",
      "args": ["mcp-remote", "https://payclaw-mcp.vercel.app/api/mcp"]
    }
  }
}

Base Mainnet

from payclaw import mainnet_config
config = mainnet_config(price_usdc=0.001, wallet_address="0xYourWallet")

const gate = requirePayment({
  priceUsdc: 0.001, walletAddress: "0xYourWallet",
  network: "base", chainId: 8453,
  usdcAddress: "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
  rpcUrl: "https://mainnet.base.org",
});

Seguridad

• Protección contra repetición mediante SQLite (Python) o Redis/KV (JS)

• Verificación de eventos de transferencia ERC-20 (no tx.value)

• Verificación de ID de cadena (previene ataques de repetición en redes de prueba)

• Verificación del estado del recibo (rechaza transacciones revertidas)

• Matemáticas de enteros para montos en USDC (sin punto flotante)

Legal

Licencia MIT. payclaw es solo software de infraestructura. No es un procesador de pagos, transmisor de dinero ni servicio financiero. No custodia fondos. Las direcciones IP pueden almacenarse temporalmente solo con fines de limitación de tasa. Úsalo bajo tu propio riesgo. El cumplimiento de las sanciones (OFAC) y las regulaciones aplicables es responsabilidad de la parte que realiza la implementación.

payclaw（繁體中文）

適用於 MCP 伺服器的 x402 支付中介軟體。讓 AI 代理每次工具呼叫使用 Base 鏈上的 USDC 付款 — 10 行程式碼，無需支付處理器，無需 KYC。

資金直接流轉：Agent 錢包 → 你的錢包。payclaw 從不持有資金。

快速開始

Python

pip install payclaw

from fastapi import FastAPI, Request
from payclaw import require_payment, PayclawConfig

app = FastAPI()
config = PayclawConfig(price_usdc=0.001, wallet_address="0x你的錢包")

@app.post("/tool")
@require_payment(config)
async def my_tool(request: Request):
    return {"result": "工具輸出"}

JavaScript / TypeScript

npm install payclaw-x402

import { requirePayment } from "payclaw-x402";

const gate = requirePayment({ priceUsdc: 0.001, walletAddress: "0x你的錢包" });

export default { fetch: gate.wrapFetch(async (req) => {
  return Response.json({ result: "工具輸出" });
})};

運作原理

1. Agent 呼叫你的工具端點

2. 無有效付款 → 伺服器返回 HTTP 402，附上價格和錢包地址

3. Agent 在 Base 鏈支付 USDC，取得 tx hash

4. Agent 帶上 X-Payment: <tx_hash> header 重試

5. payclaw 在鏈上驗證 → 執行工具

套件

線上端點： https://payclaw-mcp.vercel.app/api/mcp

法律聲明

MIT 授權。payclaw 僅為基礎設施軟體，並非支付處理器、貨幣傳輸業者或金融服務。本軟體不持有任何資金。使用風險由使用者自行承擔。遵守制裁（OFAC）及相關法規是部署方的責任。