ProvenPaid

com.provenpaidv0.1.0更新於 Oct 9, 2026

Check an x402 endpoint before your agent pays it: challenge validity and on-chain payer evidence.

已驗證STDIO僅桌面FinanceSecurity & Monitoring

概覽

AI 產生的概覽

讓助理對 x402 端點執行付費的付款前檢查，驗證其支付挑戰並回報鏈上付款方證據。

功能
提供 check_x402_endpoint 工具，用來驗證端點的 x402 支付挑戰，並回報其收款地址的公開鏈上證據，包括獨立付款方數量、重複付款方占比、付款方集中度與覆蓋率。另有兩個免費工具 provenpaid_methodology 與 provenpaid_status，分別說明各項訊號的計算方式，以及顯示付款錢包地址、網路、價格上限與當日剩餘的付費檢查次數。檢查本身會透過 Base 上的 USDC 自動付款，每次約 0.01 美元。
適用情境
適合在助理依賴某個不熟悉的付費 x402 端點之前使用一次，查看其支付挑戰是否有效，以及是否真的有錢包在付款。它並非用於每次呼叫前執行，且結果只是證據，不代表對服務品質的判定。
執行需求
本機程序，需要 Python 3.11+，可透過 uvx 或 pip 安裝。需要機密項 PROVENPAID_WALLET_PRIVATE_KEY，對應一個僅持有少量 Base 上 USDC 的專用錢包，並需要連線至 ProvenPaid API 的網路存取。選用設定包括 PROVENPAID_DAILY_LIMIT、PROVENPAID_MAX_PRICE_USD、PROVENPAID_NETWORK、PROVENPAID_API_URL 與 PROVENPAID_STATE_DIR。
安裝前請注意
此伺服器要求提供 PROVENPAID_WALLET_PRIVATE_KEY，也就是用來簽署付款授權的私鑰；README 建議使用僅存放少量資金的專用錢包，切勿使用存有重要資金的錢包。檢查會花費真實的 Base 上 USDC，每次約 0.01 美元，並受 PROVENPAID_MAX_PRICE_USD 與 PROVENPAID_DAILY_LIMIT 限制。簽署後的付款授權會離開本程序，端點 URL 也會傳送給 ProvenPaid API。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 ProvenPaid，將其新增到工作區。
  2. 為需要使用其工具的對話啟用該服務。

Desktop only，透過 STDIO。 STDIO 服務會啟動本機處理程序，因此需要 SourceWeft 桌面主機。

其他 MCP 客戶端

參照 儲存庫 中的啟動說明。

README

provenpaid-mcp

Give your agent a pre-payment check for paid x402 endpoints. Evidence before you pay.

ProvenPaid checks an x402 endpoint before your agent relies on it: is its payment challenge valid, and do real wallets actually pay it on-chain, come back, and how concentrated are payments? This MCP server exposes that check as a tool and pays for it automatically, about $0.01 in USDC on Base per check, from a wallet you control.

Use it once before relying on an unfamiliar endpoint, not before every call.

Tools

ToolCostWhat it does
check_x402_endpoint(url)about $0.01Validates the endpoint's x402 challenge and reports public on-chain evidence for its receiving address: distinct payers, repeat-payer share, payer concentration, coverage.
provenpaid_methodology()freeHow each signal is computed, what is not verified, and when a check is charged.
provenpaid_status()freePaying wallet address, network, price cap and paid checks left today.

You are not charged when the URL is invalid or unsafe, is not an x402 endpoint, or offers no payment option in USDC on Base. Results are evidence, not a verdict: ProvenPaid does not verify service quality or that an endpoint controls its receiving address.

Install

Requires Python 3.11+. With uv:

bash
uvx provenpaid-mcp

or pip install provenpaid-mcp.

Claude Desktop / Claude Code / Cursor

json
{  "mcpServers": {    "provenpaid": {      "command": "uvx",      "args": ["provenpaid-mcp"],      "env": {        "PROVENPAID_WALLET_PRIVATE_KEY": "0x...",        "PROVENPAID_DAILY_LIMIT": "20"      }    }  }}

Wallet safety

  • Use a dedicated wallet holding only a few dollars of USDC on Base. Never use a wallet with meaningful funds.
  • The key stays on your machine, in memory only. It is never logged, returned by a tool, or sent anywhere; only signed payment authorizations leave the process.
  • No ETH is needed: the payment facilitator pays network fees.

Guardrails enforced before anything is signed:

SettingDefaultMeaning
PROVENPAID_MAX_PRICE_USD0.01Refuse any check priced above this (hard ceiling 0.10).
PROVENPAID_DAILY_LIMIT20Maximum paid checks per UTC day, persisted across restarts.
PROVENPAID_NETWORKeip155:8453Pay only on this network, only in its USDC. eip155:84532 for Base Sepolia testing.
PROVENPAID_API_URLhttps://api.provenpaid.comMust be https.
PROVENPAID_STATE_DIR~/.provenpaid-mcpWhere the daily counter is kept.

How it works

The server calls GET https://api.provenpaid.com/v1/check?url=.... The API answers HTTP 402 with x402 payment requirements; the official x402 SDK signs a single-use USDC authorization within the guardrails above and retries. Settlement happens only when the check delivers evidence. Methodology: https://api.provenpaid.com/methodology

License

MIT

來源：README.md，提交 3ba55a5

工具

0
工具後設資料尚未被收錄。

版本歷史

1
  1. v0.1.0最新Oct 9, 2026