ProvenPaid

Name: ProvenPaid
Author: provenpaid.com

本地服务

api.provenpaid.com金融数据03 周前更新

代码仓库访问官网

关于 ProvenPaid

ProvenPaid 是用于预付款核查的 MCP 服务，帮助 Agent 检查陌生 x402 端点的支付挑战及接收地址的链上付款证据。结果提供证据而非服务质量判断，并对付费检查设置价格和每日限额。

主要功能

01验证 x402 支付挑战
02报告链上付款者及重复付款情况
03查看付款集中度与覆盖情况
04查询检查额度、钱包和限额
05付费前执行价格与每日限制

适用场景

01调用陌生的付费 x402 端点前检查
02比较端点接收地址的付款者分布
03查看剩余免费检查和付费额度

MCP 相关

该 MCP 服务向 Agent 提供 x402 端点检查、方法说明和状态查询工具；检查结果包含支付挑战验证及公开链上证据。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置

{
  "mcpServers": {
    "com-provenpaid": {
      "command": "uvx",
      "args": [
        "provenpaid-mcp"
      ],
      "env": {
        "PROVENPAID_WALLET_PRIVATE_KEY": "<PROVENPAID_WALLET_PRIVATE_KEY>",
        "PROVENPAID_DAILY_LIMIT": "<PROVENPAID_DAILY_LIMIT>",
        "PROVENPAID_MAX_PRICE_USD": "<PROVENPAID_MAX_PRICE_USD>"
      }
    }
  }
}

启动命令uvx provenpaid-mcp

需要配置的环境变量

PROVENPAID_WALLET_PRIVATE_KEY密钥Optional. Private key of a dedicated low-balance wallet holding USDC on Base, used only to sign payments after the 10 free checks. Not needed to try it.

PROVENPAID_DAILY_LIMITMaximum paid checks per UTC day (default 20).

PROVENPAID_MAX_PRICE_USDRefuse checks priced above this (default 0.01, hard ceiling 0.10).

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包

pypiprovenpaid-mcp0.2.0stdio

工具

收录的工具列表 · 更新于 2 周前

参数	类型	必填	说明
url	string	是

详细介绍

provenpaid-mcp

为你的 Agent 提供付费 x402 端点的付款前检查。先看证据，再付款。

ProvenPaid 会在你的 Agent 依赖某个 x402 端点之前对其进行检查：它的付款挑战是否有效？真实钱包是否会在链上付款并返回？付款的集中程度如何？此 MCP 服务将这项检查作为工具提供。**前 10 次检查免费，无需钱包，也无需设置。**之后会自动付款：每次检查约需 $0.01 的 Base 网络 USDC，款项来自你控制的钱包。

仅在依赖不熟悉的端点之前检查一次，无需在每次调用之前都检查。

工具

工具	费用	功能
`check_x402_endpoint(url)`	前 10 次免费，之后约 $0.01	验证端点的 x402 挑战，并报告其收款地址的公开链上证据：不同付款者数量、重复付款者占比、付款者集中度、覆盖范围。
`provenpaid_methodology()`	免费	说明各项信号的计算方式、未经验证的内容，以及何时会收取检查费用。
`provenpaid_status()`	免费	剩余免费检查次数、付款钱包地址、网络、价格上限以及今天剩余的付费检查次数。

如果 URL 无效或不安全、不是 x402 端点，或不提供 Base 网络上的 USDC 付款选项，则不会向你收费。结果是证据，并非结论：ProvenPaid 不会验证服务质量，也不会验证端点是否控制其收款地址。

安装

需要 Python 3.11+。使用 uv：

uvx provenpaid-mcp

或者使用 pip install provenpaid-mcp。

免费试用（无需钱包）

{
  "mcpServers": {
    "provenpaid": { "command": "uvx", "args": ["provenpaid-mcp"] }
  }
}

首次运行时，会创建一个本地身份密钥（~/.provenpaid-mcp/identity.key，仅所有者可访问）。此密钥不持有资金；它只用于让 ProvenPaid 统计你的 10 次免费检查。只有返回证据的检查才会计入次数。

免费检查次数用完后继续使用

添加一个专用的低余额钱包：

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

钱包安全

使用专用钱包，其中仅存放少量 Base 网络上的 USDC。切勿使用存有大量资金的钱包。
密钥仅保留在你的设备上，且只存在于内存中。它不会被记录、由工具返回或发送到任何地方；只有签名后的付款授权会离开进程。
无需 ETH：付款中介会支付网络费用。

在签名任何内容之前执行以下防护措施：

设置	默认值	含义
`PROVENPAID_MAX_PRICE_USD`	`0.01`	拒绝价格高于此值的检查（硬性上限为 `0.10`）。
`PROVENPAID_DAILY_LIMIT`	`20`	每个 UTC 日最多进行的付费检查次数，重启后仍会保留计数。
`PROVENPAID_NETWORK`	`eip155:8453`	仅在此网络上付款，且只使用该网络的 USDC。Base Sepolia 测试网络使用 `eip155:84532`。
`PROVENPAID_API_URL`	`https://api.provenpaid.com`	必须使用 https。
`PROVENPAID_STATE_DIR`	`~/.provenpaid-mcp`	保存每日计数器的位置。

工作原理

此服务会调用 GET https://api.provenpaid.com/v1/check?url=...。API 会以 HTTP 402 返回 x402 付款要求；官方 x402 SDK 会在上述防护措施的限制范围内签署一笔仅可使用一次的 USDC 授权并重试。只有检查返回证据后才会结算。方法说明：https://api.provenpaid.com/methodology