mcpField
P
Piprail

Piprail

本地服务
piprail.com金融数据97 周前更新
代码仓库访问官网

关于 Piprail

Piprail 是本地运行的 MCP 服务，为 AI Agent 提供自托管的 x402 支付钱包，并由操作者设定支出上限。它支持发现和登记，也可在 sovereign 模式下提供额外钱包能力。

主要功能

  1. 01设定预算上限的 x402 支付
  2. 02发现并登记支付网址
  3. 03无密钥时以只读模式运行
  4. 04支持多条链
  5. 05可选 sovereign 钱包工具

适用场景

  1. 01让 Agent 支付受 x402 限制的网址
  2. 02发现并登记支付端点
  3. 03为 Agent 钱包设置支付限额
  4. 04在 sovereign 模式启用出售与钱包工具

MCP 相关

Piprail 向 MCP 客户端提供八种默认工具，用于发现、报价、支付规划与执行、登记、预算、指南和收据验证。sovereign 模式会增加兑换、出售、收款、收入和钱包信息工具。

#x402#agent-payments#crypto-payments#usdc#stablecoin#multichain#wallet#autonomous-payments#web3

配置

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

mcp.json · 通用配置
{
  "mcpServers": {
    "piprail": {
      "command": "npx",
      "args": [
        "-y",
        "@piprail/mcp"
      ],
      "env": {
        "PIPRAIL_PRIVATE_KEY": "<PIPRAIL_PRIVATE_KEY>",
        "PIPRAIL_CHAIN": "<PIPRAIL_CHAIN>",
        "PIPRAIL_CHAINS": "<PIPRAIL_CHAINS>",
        "PIPRAIL_MAX_AMOUNT": "<PIPRAIL_MAX_AMOUNT>",
        "PIPRAIL_MAX_TOTAL": "<PIPRAIL_MAX_TOTAL>",
        "PIPRAIL_MAX_TOTAL_DENOM": "<PIPRAIL_MAX_TOTAL_DENOM>",
        "PIPRAIL_MAX_PAYMENTS": "<PIPRAIL_MAX_PAYMENTS>",
        "PIPRAIL_MAX_PAYMENTS_PER_WINDOW": "<PIPRAIL_MAX_PAYMENTS_PER_WINDOW>",
        "PIPRAIL_WARN_AT_FRACTION": "<PIPRAIL_WARN_AT_FRACTION>",
        "PIPRAIL_SPEND_LOG": "<PIPRAIL_SPEND_LOG>",
        "PIPRAIL_EVENT_LOG": "<PIPRAIL_EVENT_LOG>",
        "PIPRAIL_TOKENS": "<PIPRAIL_TOKENS>",
        "PIPRAIL_SCHEMES": "<PIPRAIL_SCHEMES>"
      }
    }
  }
}
启动命令npx -y @piprail/mcp
需要配置的环境变量
PIPRAIL_PRIVATE_KEY密钥Your wallet's private key/seed for the chosen chain. Optional: omit it to run read-only (discover/quote/register/budget/guide); set it to let the agent pay. Stays on your machine; the spend policy caps every payment.
PIPRAIL_CHAINChain to pay on (default: base).
PIPRAIL_CHAINSPay across several chains (instead of PIPRAIL_CHAIN): a comma-separated list, e.g. base,polygon,solana. Give each its own PIPRAIL_<CHAIN>_KEY (+ optional PIPRAIL_<CHAIN>_RPC_URL). The agent pays whichever chain a 402 asks for — the first listed that can settle — under one shared budget.
PIPRAIL_MAX_AMOUNTMax spend per single payment, in token units (default: 0.10).
PIPRAIL_MAX_TOTALLifetime spend cap per token, in token units (default: 10.00).
PIPRAIL_MAX_TOTAL_DENOMCross-token GRAND TOTAL: one spend cap per denomination across every stablecoin and chain, e.g. USD:20.00,EUR:5.00. Not a price oracle — sums tokens of the same unit, each counted 1:1. Native coins are excluded.
PIPRAIL_MAX_PAYMENTSLifetime cap on the NUMBER of payments, across every chain + token (e.g. 100).
PIPRAIL_MAX_PAYMENTS_PER_WINDOWCap on the number of payments within PIPRAIL_WINDOW_SECONDS (a rolling rate limit; set PIPRAIL_WINDOW_SECONDS too).
PIPRAIL_WARN_AT_FRACTIONEmit an early-warning event when spend crosses this fraction of any cap, e.g. 0.8 (80%). Needs PIPRAIL_EVENT_LOG to be visible.
PIPRAIL_SPEND_LOGPath to a local append-only spend log. When set, the budget (lifetime, grand total, counts) SURVIVES a restart — hydrated from this file. No backend; you own the file.
PIPRAIL_EVENT_LOGMirror payment events (settled / declined / budget-threshold) as one-line JSON to 'stderr' or a file path — the operator's notification stream. Default: off.
PIPRAIL_TOKENS密钥Comma-separated allowed token symbols, plus the alias 'native' for the chain's coin (default: USDC).
PIPRAIL_SCHEMESComma-separated payment schemes to settle (default: onchain-proof). Add 'exact' (onchain-proof,exact) to also pay standard x402 servers GASLESS on EVM + Solana (method auto-selected). Add 'upto' to also pay metered x402 servers on EVM (Permit2): sign a MAX, the server settles the actual <= max.

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

安装包
npm@piprail/mcp0.10.0

工具

8

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

参数类型必填说明
querystring否要搜索的自由文本主题（可选）。多词查询会按词拆分并分别搜索，结果按相关性排序，因此即使没有任何单条目包含确切短语，“crypto price feed”也能找到最佳匹配。
networkstring否CAIP-2 ID、'self'（你的链，默认值）或 'any'（所有链）。
categorystring否仅保留此类别，例如 'ai'、'finance'、'data'（严格筛选）。
assetstring否仅保留以此代币符号付款的资源，例如 'USDC'。
maxPricenumber否移除标价高于此 USD 价格的结果。
minReliabilitynumber否移除健康度分数低于此值（0–100）的结果；未评分的结果予以保留。
verifiedboolean否优先显示已验证的条目（402 Index）。
sortenum否排序方式。提供查询时默认为 'relevance'，否则按首次发现顺序。relevance | reliability | price | uptime | name
limitnumber否每个索引最多获取的结果数（默认 20）。

详细介绍

@piprail/mcp

为任何 AI Agent 提供一个受预算约束的支付钱包。 这是一个包装 @piprail/sdk 的 MCP 服务，让任何 MCP 客户端——Claude Desktop、Cursor、Claude Code、Windsurf、VS Code、Cline、OpenClaw、Hermes——都能自行支付 x402 URL，并受模型无法超出的支出策略约束。在本地使用你的钱包和你的限额运行——无需后端、无需托管、无需 Facilitator。

npx -y @piprail/mcp        # speaks MCP over stdio
📖 完整文档 → docs.piprail.com/mcp

文档是唯一的事实来源——包含每个客户端的配置、完整的环境变量参考、各种模式、各链设置以及工具参考。本 README 只是入口。

将其添加到客户端

需要两项内容：你的钱包私钥和（可选的）预算。默认值刻意设得较小且安全（每笔支付 0.10、每种代币的终身限额为 10.00、使用 Base 上的 USDC）。

{ "mcpServers": { "piprail": {
  "command": "npx", "args": ["-y", "@piprail/mcp"],
  "env": { "PIPRAIL_PRIVATE_KEY": "0xYOUR_KEY", "PIPRAIL_CHAIN": "base", "PIPRAIL_MAX_AMOUNT": "0.10" }
} } }

重启客户端后，PipRail 工具就会出现（VS Code 使用 servers，而非 mcpServers）。切勿提交你的密钥——请将其保存在客户端的 env 区块中。→ 各客户端的设置 · 配置

8 个工具 — piprail_discover · piprail_quote_payment · piprail_plan_payment · piprail_pay_request · piprail_register · piprail_budget · piprail_guide · piprail_verify_receipt。只有 piprail_pay_request 会转移资金；piprail_register 会向外部索引写入列表；其余 6 个工具均为只读。→ 工具参考

主权模式下有 14 个工具。 PIPRAIL_MODE=sovereign 会添加兑换工具、卖方工具（piprail_sell · piprail_collect · piprail_earnings）和 piprail_wallet（钱包持有什么，以及收款地址），让 Agent 掌控钱包的两面：它既可以收款，也可以付款。此模式会添加工具，而非替换工具，因此上面的默认配置不受影响。→ 模式

没有密钥？仍可运行。 如果没有 PIPRAIL_PRIVATE_KEY，服务会以只读模式启动——发现、报价、注册、预算和指南功能均可用；只有 piprail_pay_request（以及 piprail_plan_payment）需要钱包。准备好实际付款时再添加密钥。

需要跨链付款？ 列出多个链并为每条链提供自己的密钥——之后工具会根据 402 请求在相应链上付款（一个服务，一个预算）：

"env": {
  "PIPRAIL_CHAINS": "base,polygon,solana",
  "PIPRAIL_BASE_KEY": "0x…", "PIPRAIL_POLYGON_KEY": "0x…", "PIPRAIL_SOLANA_KEY": "<base58-secret>",
  "PIPRAIL_MAX_AMOUNT": "1.00"
}

一个 EVM 密钥可用于所有 EVM 链；非 EVM 家族各自需要自己的密钥（以及该家族对应的 peer 库）。没有密钥的链只能只读。→ 配置

已作为 io.github.piprail/mcp 列入官方 MCP 注册表。

默认情况下不会执行的操作

默认工具集中没有兑换工具，这是刻意为之：支出策略不约束兑换。 这里的每项预算上限都约束向商家付款，而兑换是在不同币种之间转移你自己的资金，因此，能够兑换的 Agent 可能通过手续费和滑点耗尽钱包资金，而不会触发任何预算检查。

这正是应当限制该能力的理由，而不是假装它不存在。PIPRAIL_MODE=sovereign 会为声明 Agent 拥有此钱包的操作员解锁兑换功能，并要求设置 PIPRAIL_MAX_PER_SWAP 后服务才会启动，因为付款上限无法约束兑换。模型永远不能自行设置模式。

主权模式还会解锁出售功能，它无需设置上限：出售会收款而非支出，并且收款端完全不持有私钥。

文档

概览 · 快速入门项目介绍 · 首次运行
客户端设置 · 配置各客户端配置 · 所有环境变量
工具 · 模式8 个默认工具（主权模式下为 14 个） · 无头模式与受监督模式
安全 · 链安全性说明 · 各链的设置
作为库使用 · 常见问题嵌入使用 · 常见问题

传播消息

免费、开源、自我托管密钥——没有后端向你推销。如果 PipRail 为你的 Agent 提供了一个值得信赖的钱包，请帮助更多人发现它：

⭐ 在 GitHub 上点星  ·  𝕏 关注 @piprailhq  ·  🌐 piprail.com  ·  📖 docs.piprail.com

文档 · PipRail · @piprail/sdk · x402 · Model Context Protocol

MIT · 永不设后端，永不收费。

评论

支持 Markdown

第一次接触 MCP？

从协议是什么，到在客户端里装上第一个服务，这几条回答覆盖了大多数入门问题。

一个开放协议，规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话，MCP 服务负责提供工具、资源和提示模板，两者通过标准消息通信，同一个服务可以被不同客户端复用。