Veyline by Payload

Veyline by Payload — MCP サーバー

AI エージェントに Payload の主要なノンカストディアル認可レイヤーである Veyline を公開する MCP サーバーです（stdio トランスポート、Node.js 標準ライブラリのみを使用、依存関係ゼロ）。

Veyline は、ポリシーに基づいて、ウォレットが署名する前にエージェントによる支払いを進めてよいかどうかを判断します。このサーバーは、Payload レールの Veyline A2A スキルを MCP ツールとしてラップします。すべてのツール呼び出しは、ご自身のレール API キーを使って認証し、ご自身がすでに所有している Veyline 組織のために、ライブの Payload レール（https://payload-rail.fly.dev）へ送信されます。

ツール

ツール	上流ルート	機能
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 の追加

Veyline は、支払いを行おうとするエージェントと、署名するウォレットの間に位置します。既存のスタックに追加するものであり、Veyline を中心に再構築する必要はありません。

1. エージェントが実行しようとする支払いを特定します。 アプリケーションは受取人、金額、資産、ネットワークを把握しています。
2. アプリケーションが正式な支払い詳細を取得します。 x402 価格設定のアクションでは、エージェントが推測した数値ではなく、販売者から返された元の見積もりを使用します。
3. Veyline が提案されたアクションを評価します。 完全な正式な見積もりと、それに関連付けられたリクエストハッシュ、アクション、セント単位の金額、受取人、資産、CAIP-2 ネットワーク、見積もり ID を指定して veyline_preflight を呼び出します。不完全な見積もりリクエストは安全側に倒して拒否されます。Veyline は、何かが署名される前に、組織の認可ポリシー、支出上限、許可された受取人に照らしてリクエストを確認します。
4. 条件を満たすリクエストには、スコープが限定され、署名付きで、有効期限のある認可が発行されます。 事前審査は、その支払い意図に紐づいた、署名付きで有効期間の短い認可を返します。ポリシーに適合しないリクエストは拒否され、処理は進みません。
5. ご自身のウォレットまたは署名者が支払いを実行します。 顧客のウォレット、署名者、または承認済みの実行システムが、認可された範囲内で支払いを実行します。Veyline が資金を保有することはなく、ご自身のウォレットに代わって署名することもありません。
6. 対応する機能を通じて証跡を記録または検証します。 アプリケーションは、事前審査の結果を認可対象の支払いと合わせて保持します。同じレール上では、RevRule が元の利用資格エントリーに紐づく支払い証跡を記録するため、後から支払い額を本来の債務額と照合できます。

残る 2 つの読み取り機能で統合を補完できます。veyline_status は組織の利用資格とティアを報告し、veyline_usage はクォータと使用状況を報告します。どちらも支払いを認可するものではありません。

簡単に言えば、Veyline は顧客資金を保管することなく、ガバナンスと認可を提供します。支払いを自ら実行することはなく、外部の決済システム、ネットワーク、取引相手に障害が発生しないことを保証するものでもありません。Veyline が保証するのは、より限定的で実用的なことです。つまり、アプリケーションが事前審査を経由させた支払いは、ウォレットが署名する前にポリシーチェックを受けます。

無料で評価してから、サブスクリプションに登録

• 評価： https://payloadhq.github.io/veyline.html のサンドボックス登録から無料の Payload rail API キーを取得するか（メールアドレスのみで登録できる、月間1,000回の操作が可能な無料プラン）、https://payload-rail.fly.dev/revrule-console/ のコンソールから取得し、Veyline の組織で使用してください。以下の検証済み MCPB リリースをインストールしてください。事前設定済みのキーは含まれていません。
• 有料： Veyline Developer サブスクリプションは https://payloadhq.github.io/veyline.html から月額99ドルで利用でき、ポリシーに基づく認可を処理に組み込む必要がある、決済対応エージェントおよび API 向けの本番環境用プランです。

インストール

検証済み MCPB リリース

veyline v1.1.0 MCPB bundle を MCPB 対応クライアントにインストールするか、以下の手順でソースから実行してください。公開されたバンドルには、サポート対象の 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 の主力製品です。x402 の従量課金アクション向け MCP クライアントレイヤーである Payload の callx402 もご覧ください。