Piprail

@piprail/mcp

予算の上限がある決済ウォレットを、あらゆる AI エージェントに持たせましょう。 @piprail/sdk をラップした MCP サーバーです。Claude Desktop、Cursor、Claude Code、Windsurf、VS Code、Cline、OpenClaw、Hermes など、あらゆる MCP クライアントが x402 の URL に独自に支払いを行えます。支出ポリシーで上限が設定されているため、モデルが超過することはできません。あなたのウォレットとあなたの上限を使ってローカルで動作します。バックエンドも、資産の預かりも、ファシリテーターも不要です。

npx -y @piprail/mcp        # speaks MCP over stdio

📖 詳細なドキュメント → docs.piprail.com/mcp

ドキュメントが唯一の信頼できる情報源です。各クライアントの設定、環境変数の完全なリファレンス、各モード、チェーンごとのセットアップ、ツールのリファレンスをすべて記載しています。この README は入口にすぎません。

---

クライアントに追加する

必要なものは、ウォレットの秘密鍵と（任意で）予算の2つです。デフォルト値は意図的に小さく、安全に設定されています（1回あたり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 では mcpServers ではなく servers を使います）。秘密鍵をコミットしないでください。クライアントの 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（保有資産と、支払いを受け取るアドレス）が追加され、エージェントはウォレットの両方の機能を使えるようになります。支払いを行うだけでなく、支払いを受け取ることもできます。デフォルトのツールを置き換えるのではなく追加するため、上記のデフォルト設定には影響しません。→ モード

秘密鍵がなくても動作します。 PIPRAIL_PRIVATE_KEY が設定されていない場合、サーバーは読み取り専用モードで起動します。検索、見積もり、登録、予算の確認、ガイドはすべて利用できますが、ウォレットが必要なのは piprail_pay_request（および piprail_plan_payment）のみです。実際に支払いを行う準備ができたら、鍵を追加してください。

複数のチェーンで支払いますか？ 複数のチェーンを指定し、それぞれに独自の鍵を設定すると、402 で要求されたチェーンに応じてツールが支払います（サーバーは1つ、予算も1つです）。

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

1つの EVM キーをすべての EVM チェーンで使用できます。非 EVM ファミリーでは、それぞれ独自の鍵（およびそのファミリーのピアライブラリ）が必要です。鍵が設定されていないチェーンは読み取り専用になります。→ 設定

公式のMCP レジストリに io.github.piprail/mcp として登録されています。

---

デフォルトでは実行されないこと

デフォルトのツールセットにスワップツールはありません。これは意図的なものです。支出ポリシーはスワップを制御しません。 ここでの予算上限はすべて加盟店への支払いを制限します。一方、スワップでは自分の資金を異なる通貨単位の間で移動するため、スワップが可能なエージェントは、予算チェックに一度も引っかかることなく、手数料とスリッページによってウォレットの資金を枯渇させる可能性があります。

これは機能を制限すべき理由であって、存在しないことにする理由ではありません。PIPRAIL_MODE=sovereign を設定すると、エージェントがこのウォレットを所有することを認めるオペレーター向けにスワップ機能が有効になります。また、支払いの上限ではスワップを制限できないため、サーバーの起動前に PIPRAIL_MAX_PER_SWAP が必須になります。モデルが自らのモードを設定することはできません。

ソブリンモードでは販売機能も有効になります。資金を使うのではなく受け取るため、上限は不要です。また、受け取り側が秘密鍵を持つこともありません。

ドキュメント

概要 · はじめに	概要 · 初回実行
クライアントのセットアップ · 設定	クライアントごとの設定 · すべての環境変数
ツール · モード	デフォルトの8つのツール（ソブリンでは14個） · ヘッドレスと監視あり
セキュリティ · チェーン	安全な理由 · チェーンごとのセットアップ
ライブラリとして使用 · FAQ	アプリへの組み込み · よくある質問

広めましょう

無料、オープンソース、セルフカストディ型 — 販売目的のバックエンドはありません。PipRailによってエージェントが信頼できるウォレットを使えるようになったなら、ほかの人にも知ってもらえるようご協力ください。

⭐ GitHubでスターを付ける  ·  𝕏 @piprailhqをフォロー  ·  🌐 piprail.com  ·  📖 docs.piprail.com

---

ドキュメント · PipRail · @piprail/sdk · x402 · Model Context Protocol

MIT · バックエンドなし、手数料なし、今後もずっと。