payclaw

English | 繁體中文

Готовое x402 платежное промежуточное ПО для MCP-серверов. Взимайте плату с AI-агентов за каждый вызов инструмента с помощью USDC в сети Base — 10 строк кода, без платежных процессоров и KYC.

Деньги поступают напрямую: кошелек агента → ваш кошелек. 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="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

Как это работает

1. Агент вызывает ваш эндпоинт инструмента

2. Если оплата отсутствует → сервер возвращает HTTP 402 с ценой и адресом кошелька

3. Агент оплачивает USDC в сети Base и получает tx hash

4. Агент повторяет запрос с заголовком X-Payment: <tx_hash>

5. payclaw проверяет транзакцию в блокчейне → выполняет ваш инструмент

Пакеты

Рабочий эндпоинт: https://payclaw-mcp.vercel.app/api/mcp

Подключитесь через Claude Desktop:

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

Основная сеть Base

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",
});

Безопасность

• Защита от повторов (replay protection) через SQLite (Python) или Redis/KV (JS)

• Проверка события перевода ERC-20 (не tx.value)

• Проверка ID сети (предотвращает атаки повтора из тестовых сетей)

• Проверка статуса квитанции (отклоняет отмененные транзакции)

• Целочисленная математика для сумм USDC (без чисел с плавающей запятой)

Юридическая информация

Лицензия MIT. payclaw — это только инфраструктурное программное обеспечение. Оно не является платежным процессором, оператором денежных переводов или финансовой службой. Оно не хранит средства. IP-адреса могут временно сохраняться только для целей ограничения частоты запросов (rate limiting). Используйте на свой страх и риск. Соблюдение санкций (OFAC) и применимых нормативных актов является обязанностью стороны, развертывающей ПО.

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）及相關法規是部署方的責任。