RevRule by Payload

Payload 的 RevRule — MCP 服务

一个 MCP 服务（stdio 传输，仅使用 Node.js 标准库，零依赖），可将 Payload 的收入权益引擎 RevRule 提供给 AI Agent 使用。

RevRule 将收入分成转化为 Payload 通道上的声明式权益规则：定义谁应获得多少报酬，每笔付款都会附带证据，并关联回原始权益账本条目及其链上结算。此服务提供读取 + 试运行功能：v1 中刻意不包含任何写入／提交工具。每次调用都会访问实时 Payload 通道（https://payload-rail.fly.dev），并使用你自己的通道 API 密钥进行身份验证（使用控制台提供的免费自助密钥即可进行评估）。

工具

工具	上游路由	功能
revrule_get_graph	GET /v1/graphs/{graph_id}	按 ID 获取你的某个 RevRule 收入权益图：包括参与方、规则和账本接线信息。只读。
revrule_list_payout_evidence	GET /v1/graphs/{graph_id}/payout-evidence	列出某个图记录的付款证据：已验证的付款及其关联的原始权益账本条目（交易哈希、日志索引、区块数据、授权签名）。只读。
revrule_simulate_event	POST /v1/graphs/{graph_id}/simulate	根据某个图的规则试运行收入事件，并查看规则将产生的结果，且不会产生任何副作用：不会记录任何内容，也不会准备或提交付款。此工具会将提供的事件包装为 {event: ...}，再发送到生产通道；模拟不会产生副作用。

安装

已验证的 MCPB 发行版

在兼容 MCPB 的客户端中安装 revrule v1.1.0 MCPB bundle，或按下文所述从源代码运行。已发布的 bundle 声明了受支持的 MCP 工具。第三方目录列表重新验证期间，此直接发行版是经过验证的安装途径。

从源代码安装

git clone https://github.com/Payloadhq/revrule-mcp
cd revrule-mcp
node mcp/index.js

也可以通过 npx 直接从 GitHub 运行：

npx -y github:Payloadhq/revrule-mcp

MCP 客户端配置（stdio）：

{
  "mcpServers": {
    "revrule": {
      "command": "node",
      "args": ["/path/to/revrule-mcp/mcp/index.js"],
      "env": {
        "PAYLOAD_RAIL_API_KEY": "your-rail-api-key"
      }
    }
  }
}

配置

变量	必填	默认值	用途
PAYLOAD_RAIL_API_KEY	调用工具时必填	—	你自己的 Payload 通道 API 密钥。控制台提供的免费自助密钥可用于评估；付费许可证适用于生产环境。该密钥仅通过 Bearer Authorization 标头发送到通道。
PAYLOAD_RAIL_URL	可选	https://payload-rail.fly.dev	Payload 通道基础 URL。

**失败时默认拒绝：**未配置 API 密钥时，服务仍会启动并列出其工具，但每次工具调用都会返回清晰的 API key not configured 错误。除作为 Authorization 标头发送到通道外，密钥绝不会离开你的设备。

免费评估与付费许可证

**免费。**无需付费即可端到端评估 RevRule：

• RevRule 沙盒会在浏览器中运行实际引擎：定义图、触发事件并检查权益账本。
• RevRule 控制台可签发免费的 Payload 通道自助 API 密钥。使用该密钥，此服务的读取工具（revrule_get_graph、revrule_list_payout_evidence）和零副作用试运行工具（revrule_simulate_event）都可以针对你自己的图运行。评估无需付费权益。

付费。RevRule 许可证为一次性付费 $99。这是面向生产环境的产品：在通道上运行真实收入图，以权益账本和付款证据作为事实来源，而不是在沙盒中评估。

RevRule 会计算各方应得的金额并记录证据。它不会执行付款，也绝不会持有资金；资金由你自己的系统和支付合作伙伴转移。

许可证

MIT —— 详见 LICENSE。

---

RevRule 是 Payload 的产品，与 Veyline（Payload 的授权层）以及 Payload 推出的 callx402（用于按 x402 计价操作的 MCP 客户端层）相互独立。