Veyline by Payload

Veyline by Payload — MCP 服务

一个 MCP 服务（stdio 传输，仅使用 Node.js 标准库，零依赖），可向 AI Agent 提供 Payload 的旗舰级非托管授权层 Veyline。

在任何钱包签名之前，Veyline 会根据策略判断 Agent 是否可以继续付款。此服务将 Payload rail 的 Veyline A2A 技能封装为 MCP 工具。每次工具调用都会使用你自己的 rail API 密钥，通过实时 Payload rail（https://payload-rail.fly.dev）进行身份验证，操作你自己已有的 Veyline 组织。

工具

工具	上游路由	功能
veyline_status	POST /v1/a2a（A2A 技能 veyline_status）	读取当前已通过身份验证的组织的 Veyline 权限和层级。不会授权付款。
veyline_usage	POST /v1/a2a（A2A 技能 veyline_usage）	读取当前已通过身份验证的组织的配额和使用情况。不会更改策略。
veyline_preflight	POST /v1/a2a（A2A 技能 veyline_preflight）	请求经策略强制执行的签名短时效付款预检。不会转移资金。 需要 Veyline 执行范围和原始权威 x402 报价。输入包括权威的 protocol、provider、action、network（eip155:8453）、asset、amount_cents、recipient、request_hash、quote_id 和 quote。

将 Veyline 添加到 Agent 工作流

Veyline 位于希望付款的 Agent 与进行签名的钱包之间。你可以将它添加到已有的技术栈中，无需围绕它重建系统。

1. Agent 确定要进行的付款。 你的应用程序知道收款方、金额、资产和网络。
2. 应用程序获取权威付款详情。 对于按 x402 定价的操作，这应是卖方返回的原始报价，而不是 Agent 猜测的数字。
3. Veyline 评估拟议操作。 使用完整的权威报价及其关联的请求哈希、操作、以分为单位的金额、收款方、资产、CAIP-2 网络和报价 ID 调用 veyline_preflight。不完整的报价请求会被默认拒绝。Veyline 会在签名之前，根据组织的授权策略、支出限额和允许的收款方检查请求。
4. 符合条件的请求会获得范围受限、经签名且会过期的授权。 预检会返回一份经签名、短时效且绑定到该付款意图的授权。超出策略范围的请求会被拒绝，后续操作不会继续。
5. 由你自己的钱包或签名方执行付款。 客户的钱包、签名方或获批的执行系统会在授权范围内完成付款。Veyline 从不持有资金，也不会代替你的钱包签名。
6. 通过支持的功能记录或验证凭证。 你的应用程序会将预检结果与其授权的付款一并保存。在同一 rail 上，RevRule 会记录与原始权限条目关联的付款凭证，以便日后核验付款是否符合应付金额。

集成还包括两项查询：veyline_status 会报告组织的权限和层级，veyline_usage 会报告配额和使用情况。两者都不会授权付款。

简单来说：Veyline 在不托管客户资金的情况下提供治理和授权。它本身不会执行付款，也无法保证外部支付系统、网络或交易对手不会发生故障。它能保证的范围更窄，但很实用：应用程序通过预检发起的付款，会在任何钱包签名前经过策略检查。

先免费评估，再订阅

• **评估：**通过 https://payloadhq.github.io/veyline.html 上的沙盒注册获取免费的 Payload rail API 密钥（仅需邮箱，免费套餐每月提供 1,000 次操作），或通过 https://payload-rail.fly.dev/revrule-console/ 获取，并在你的 Veyline 组织中使用。安装下方经过验证的 MCPB 发行包；其中不包含预配置密钥。
• **付费：**Veyline Developer 订阅每月 $99 起，可通过 https://payloadhq.github.io/veyline.html 订阅。这是支付功能已启用的 Agent 和 API 的生产方案，可在授权流程中强制执行策略。

安装

经过验证的 MCPB 发行包

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

从源代码安装

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

也可以使用 npx 直接从 GitHub 运行：

npx -y github:Payloadhq/veyline-mcp

MCP 客户端配置（stdio）：

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

配置

变量	必填	默认值	用途
PAYLOAD_RAIL_API_KEY	调用工具时必填	—	适用于现有 Veyline 组织的专属 Payload rail API 密钥。仅作为 Bearer Authorization 标头发送给 rail。
PAYLOAD_RAIL_URL	可选	https://payload-rail.fly.dev	Payload rail 基础 URL。

**失败时默认拒绝：**未配置 API 密钥时，服务仍会启动并列出其工具，但每次工具调用都会返回明确的 API key not configured 错误。没有你的密钥，任何内容都不会被发送到任何地方；密钥也不会离开你的计算机，除非作为 Authorization 标头发送给 rail。

说明

• 预检是授权检查，不是支付：不会转移资金。
• 你需要在 Payload rail 上拥有现有 Veyline 组织，工具才能返回数据。

许可证

MIT — 参见 LICENSE。

---

Veyline 是 Payload 的旗舰产品。另请参阅 Payload 的 callx402，这是适用于 x402 定价操作的 MCP 客户端层。