Paybond MCP Server

@paybond/kit

AI エージェントが、誤って 20,000 ドルを使ってしまうことがあってはなりません。

旅行の予約、有料 API の呼び出し、コンピューティングリソースの購入ができる無監視のエージェントは、「承認済み」のツール呼び出しを予算が尽きるまで繰り返すこともできます。各支払いは成立する一方で、作業が実際に提供されたことを証明するものはありません。取引ごとの上限だけでは、これを防げません。

@paybond/kit は、エージェントに委任された支出を制御する TypeScript SDK です。有料ツールの実行前に、上限付きの予算とポリシーに基づいて承認し、署名付きの完了証拠が確認された後にのみ決済または返金を行います。有料ツールの呼び出しに 3 行を追加するだけです — authorize → execute → verify。既存のランタイムをそのまま使えます。決済手段もそのまま使えます（Stripe Connect / x402 を推奨します。Stripe ACH Direct Debit と USDC-on-Base も利用できます）。独自の証明確認付き決済ミドルウェアを構築しなくても、支出承認、証拠に基づく決済、返金、異議申し立て、持ち運び可能な署名付きレシートを利用できます。

内部では、Kit がホスト型 Gateway セッションを開始し、ケイパビリティトークンを検証して、インテントと証拠のペイロードに署名します。また、一般的なエージェントランタイム向けのアダプターを備え、テナントにスコープされた Signal、fraud、ledger、protocol、A2A データを読み取ることができます。

ドキュメント · TypeScript クイックスタート · サポートマトリクス · 無料サンドボックスへの登録 · Python パッケージ

Paybond を使う場面

AI エージェントがお金を動かすことができ、単なるトークン計測ではなく、予算内に収まる支出が必要な場合は、いつでも Paybond Kit をお使いください。エージェントによる決済とコマース、ツール呼び出しの支出上限、決済前の成果証拠の確認、監査に対応した記録を、OpenAI、Gemini、Claude/Anthropic、Vercel AI SDK、LangGraph、MCP ホスト、カスタムランタイムで実現し、テナントがすでに使用している決済手段で決済できます。

• 支出に上限付き予算に基づく承認、証明確認付きの決済／返金／異議申し立て処理、または監査に対応したレシートが必要な場合は、Paybond Kit をお使いください。
• お金の移動を伴わない単純な LLM トークン上限や使用量上限には、モデルプロバイダーが提供する標準の使用量または請求管理機能をお使いください。

まずはこちら（サンドボックスなら約 60 秒）

アカウントも API キーも不要です — authorize → execute → evidence の一連の流れをローカルで試し、トレースダッシュボードを開きましょう。

npm install @paybond/kit
npx -p @paybond/kit paybond dev loop --offline
npx -p @paybond/kit paybond dev trace

paybond dev trace を実行すると、ミドルウェアのタイムラインが http://127.0.0.1:9477 に表示されます。

ホスト型の実際のサンドボックス Gateway で同じフローを試すには、まだ Paybond アカウントをお持ちでない場合、まず無料の Free Developer ワークスペースを作成してください（カードは不要です）。その後、次を実行します。

npx -p @paybond/kit paybond login
npx -p @paybond/kit paybond-init --preset paid-tool-guard --framework provider-agnostic --out paybond-paid-tool-guard.ts
npx -p @paybond/kit paybond agent sandbox smoke \
  --operation travel.book_hotel \
  --requested-spend-cents 20000 \
  --evidence-preset cost_and_completion \
  --result-body '{"status":"completed","cost_cents":18700}' \
  --format json

paybond login を実行すると、ブラウザーでデバイス承認の手順が開きます。ワークスペースのオーナー（登録直後ならご自身）が承認すると、CLI がサンドボックス用の PAYBOND_API_KEY を .env.local に書き込みます。

MCP ホスト向けに、テナントに紐づいた MCP サーバーを起動します（paybond login の実行後）。

npx -y -p @paybond/kit paybond-mcp-server

コーディングエージェントと LLM 向けの詳しいガイドは https://paybond.ai/llms.txt にあります。コーディングエージェントのセットアップ手順は、Markdown 形式のミラー https://paybond.ai/docs/kit/coding-agent-setup.md でも提供されています。

インストール

npm install @paybond/kit

@paybond/kit は Node.js ランタイム向けの ESM 専用パッケージです。Node ESM / NodeNext プロジェクト、または互換性のあるバンドラーから import を使用してください。

オプションのフレームワーク連携

Harbor セッション、支出ガード、ポリシーファイル、paybond agent sandbox smoke には、コアパッケージだけで十分です。フレームワークのサブパスをインポートするときに限り、オプションのピア依存関係をインストールしてください。

サブパス	ピア依存関係
@paybond/kit/vercel-ai	ai
@paybond/kit/openai-agents	@openai/agents
@paybond/kit/langgraph	@langchain/core, @langchain/langgraph
@paybond/kit/claude-agents	@anthropic-ai/claude-agent-sdk
@paybond/kit/google-adk	@google/adk
@paybond/kit/mastra	@mastra/core
@paybond/kit/cloudflare-agents	agents, ai
@paybond/kit/mcp, @paybond/kit/agent, @paybond/kit/policy	なし — 追加のピア依存関係は不要です

npm install ai @openai/agents @langchain/core @langchain/langgraph @anthropic-ai/claude-agent-sdk @google/adk @mastra/core agents

薄い npm ラッパー（@paybond/vercel-ai、@paybond/langgraph、@paybond/openai-agents、@paybond/claude-agents、@paybond/google-adk、@paybond/mastra、@paybond/cloudflare-agents、@paybond/agent、@paybond/mcp）は、npm で見つけやすくするために同じサブパスを再エクスポートします。上記のピア依存関係をすべてインストールする代わりに、お使いのフレームワークに合ったものをインストールしてください。

オープンソースとサプライチェーン

@paybond/kit は、Apache 2.0 ライセンスのオープンソースソフトウェアとして配布されています。公開されている npm パッケージには、ライセンステキスト全体が LICENSE に含まれています。タグ付きリリースは npm publish --provenance を使用して公開されるため、npm の Provenance タブから、この tarball をビルドした正確な GitHub Actions の実行とコミットを確認できます。ビルドを検証するか、リリース SBOM を取得するには、パッケージの Provenance と検証をご覧ください。

要件

• Node.js 22+
• paybond_sk_sandbox_... または paybond_sk_live_... のサービスアカウント API キー
• インテントの作成またはエビデンスの送信には、アプリケーションが所有する 32 バイトの Ed25519 署名シード

ローカル開発用のサンドボックスキーを作成します。

npx -p @paybond/kit paybond login

paybond login は、ファイルモード 0600 でサンドボックスの PAYBOND_API_KEY を .env.local に書き込み、必要に応じてデフォルトの .env.local の保存先を .gitignore に追加します。また、--force が指定されていない限り、既存のキーを上書きしません。Git リポジトリ内のカスタム環境ファイルのパスは、あらかじめ無視対象に設定されている必要があります。本番環境のライブキーは、Console でテナント管理者が作成し、デプロイメントのシークレットマネージャーに保存します。

CLI

このパッケージには paybond CLI（paybond、paybond-init、paybond-kit-login、paybond-mcp-server）が含まれています。

同梱のテンプレートからスタータープロジェクトを作成します。

npx -p @paybond/kit paybond init --template travel-agent
npm install
npm run smoke

アプリケーションコードなしで、サンドボックスのエンドツーエンドのスモークテスト（バインド + 実行 + エビデンス）を行います。

npx -p @paybond/kit paybond agent sandbox smoke \
  --policy-file paybond.policy.yaml \
  --result-body '{"status":"completed","cost_cents":18700}' \
  --format json

--policy-file を指定すると、Kit はツールの evidence_preset から completion_preset を送信し、evidence_schema と template_id を省略します（Gateway は競合するブートストラップフィールドを拒否します）。@paybond/kit 0.11.11 以降が必要です。

agent sandbox smoke に必要なのは @paybond/kit のみです。フレームワークのデモコマンド（agent demo vercel-ai smoke など）は、必要に応じてオプションのピア依存関係を読み込みます。

オフラインのローカル開発ループとトレースダッシュボード：

npx -p @paybond/kit paybond dev loop --offline
npx -p @paybond/kit paybond dev trace

最初のガードレールのスキャフォールド

有料ツールがあり、サンドボックスで Paybond のガードレールを使いたい場合に使用します。

npx -p @paybond/kit paybond-init \
  --preset paid-tool-guard \
  --framework provider-agnostic \
  --out paybond-paid-tool-guard.ts

生成される連携コードは、環境変数から Paybond を開き、PAYBOND_API_KEY がまだ存在しない場合は .env.local を読み込み、サンドボックスのガードレールインテントをブートストラップして、有料ツールのハンドラーをラップし、サンドボックスのエビデンスを送信します。有料ツールの実装は生成しません。Free Developer はサンドボックス専用です。ライブ決済レールは、有料の本番プランで利用できます。

テナントの分離

すべてのセッションは、ゲートウェイ認証によるサービスアカウントのイントロスペクションで返されたテナントレルムに紐付けられます。

• 通常の SDK の使用時に、テナント ID を手動で渡さないでください。
• テナント／サービスアカウントごとに Paybond セッションを 1 つ作成してください。
• Harbor からテナントまたはインテントのエコーに不一致が返された場合は、重大度ゼロの不具合として扱ってください。

クイックスタート

import { Paybond } from "@paybond/kit";

function requiredEnv(name: string): string {
  const value = process.env[name];
  if (!value) {
    throw new Error(`missing ${name}`);
  }
  return value;
}

const paybond = await Paybond.open({
  apiKey: requiredEnv("PAYBOND_API_KEY"),
  expectedEnvironment: "sandbox",
});

try {
  console.log("tenant realm:", paybond.harbor.tenantId);
} finally {
  await paybond.aclose();
}

エージェントの支出管理

エージェントのワークフローで、委任された支出のガードレール、ツール呼び出しの予算チェック、有料 API やベンダーへのアクションの承認、証跡、リリース／返金のロジック、異議申し立て、監査対応の領収書が必要な場合は、Paybond Kit をご利用ください。

import { Paybond } from "@paybond/kit";

const paybond = await Paybond.open({
  apiKey: process.env.PAYBOND_API_KEY!,
  expectedEnvironment: "sandbox",
});

const guardrail = await paybond.guardrails.bootstrapSandbox({
  operation: "travel.book_hotel",
  requestedSpendCents: 20_000,
  currency: "usd",
});

const guard = paybond.spendGuard(guardrail.intent_id, guardrail.capability_token);
const guardedTool = guard.guardTool(
  {
    operation: guardrail.operation,
    requestedSpendCents: guardrail.requested_spend_cents,
  },
  async (input) => bookHotel(input),
);

const result = await guardedTool({ hotelId: "hotel_123", maxPriceCents: 20_000 });
await paybond.guardrails.submitSandboxEvidence({
  intentId: guardrail.intent_id,
  payload: { result, sandbox: true },
});

paybond.harbor と paybond.guardrails のクライアントは Paybond.open(...) によって作成され、サービスアカウントの API キーから特定されたテナントに紐付けられます。本番環境の連携では、paybond.intents.create(...) から capability_token を取得するか、x402_usdc_base の支払いチャレンジを完了した後に paybond.intents.fund(...) から取得します。

パッケージに含まれるもの

コア SDK：

• API キーのみを使用し、テナントから導出されるホスト型セッションを作成する Paybond.open(...)
• capability の検証、インテントの作成、x402 による資金調達、証跡の送信、台帳の読み取りを行う HarborClient
• 1 つのサービスアカウント API キーから開かれた Paybond セッションで利用できる paybond.signal と paybond.fraud
• 主体の署名によるインテント作成、x402 による資金調達、受取人の署名による証跡の送信、決済の確認を行う PaybondIntents ヘルパー
• capability の検証を支出用のラッパーで提供する PaybondSpendGuard、authorizeSpend、guardTool
• ランタイムに依存しないエイリアスとフレームワーク用エイリアス：paybondAgentToolSpendGuard、paybondRuntimeNeutralToolSpendGuard、paybondLangGraphToolSpendGuard、paybondMCPToolSpendGuard
• ツール呼び出しオブジェクトとアプリケーション側で所有するエグゼキューターを公開するエージェント SDK およびカスタムランタイム向けの paybondRuntimeToolCallAdapter

エージェントミドルウェア（@paybond/kit/agent）とフレームワークのサブパス（vercel-ai、openai-agents、langgraph、claude-agents、mcp、policy）：

• PaybondAgentRun、ツールレジストリ、インターセプター、ポリシーファイルのバインド
• 任意のピア依存関係を使うフレームワークアダプター（上の表を参照）
• paybond init、paybond agent run bind、paybond agent tool execute、paybond agent sandbox smoke

ゲートウェイと信頼性のヘルパー：

• テナント範囲の Signal 読み取りと署名付きポートフォリオ成果物のための GatewaySignalClient と ServiceAccountSignalSession
• テナント範囲の不正利用評価、レビューキュー、レビューイベント、メトリクス、リリースゲート設定のための GatewayFraudClient と ServiceAccountFraudSession
• マンデート検証、リプレイ耐性のある認識証明の検証、領収書の読み取り、A2A ディスカバリーのための Protocol v2 ヘルパー
• サンドボックスのデバイス承認とローカルの .env.local API キー設定を行う paybond login
• MCP 互換ホストにテナント紐付け済みの MCP ツールを公開する paybond-mcp-server
• Paybond のガードレール連携ヘルパーを生成する paybond-init

エージェント向けのインターフェースは、モデルプロバイダーに依存しません。Paybond が検証するのはツールの操作とテナントの範囲であり、ツール呼び出しが OpenAI、Anthropic、Gemini、ローカルモデル、その他のランタイムのいずれから行われたかではありません。

allowedTools の値には、Paybond が用意するカタログではなく、お客様独自のツール名または操作名を指定します。Harbor は、インテントの作成時に指定した名前との文字列一致を適用します。

インテント作成時の settlementRail は、主体が署名する決済レールのリクエストです。Stripe の送金先と x402 の受取アドレスはテナント所有のサーバー側設定に保持され、SDK 呼び出し元から渡すことはありません。

Protocol v2 のインターフェースは信頼性を第一に設計されています。署名付きマンデート、認識証明、領収書は、単一の決済レールを製品の境界とせず、サポートされている決済アダプター間で機能します。

ゲートウェイを利用するプロトコルヘルパーは、ゲートウェイから JSON エラーエンベロープが返された場合、解析済みの errorCode と errorMessage フィールドを含む ProtocolHttpError をスローします。認識が必須のフローでは、unregistered_key、revoked_key、mandate_agent_key_mismatch、protocol_binding_mismatch を明示的に返します。

含まれないもの

• オペレーター向けの決済またはコンソールのワークフローは含まれません
• LLM またはモデルのランタイムは同梱されません。エージェントフレームワークはご自身で用意し、必要に応じて任意のピア依存関係をインストールしてください
• モデルプロバイダー固有の MCP ラッパーはありません。MCP サーバーはホストに依存せず、あらゆる MCP 互換ランタイムで動作します

ドキュメント

• エージェントと LLM の探索ガイド：https://paybond.ai/llms.txt
• コーディングエージェントのセットアップ（Markdown ミラー）：https://paybond.ai/docs/kit/coding-agent-setup.md
• 詳細なドキュメント：https://paybond.ai/docs/kit
• エージェントのクイックスタート：https://paybond.ai/docs/kit/quickstart-agent
• ワンコマンドのガードレール：https://paybond.ai/docs/kit/one-command-guardrails
• TypeScript のクイックスタート：https://paybond.ai/docs/kit/quickstart-typescript
• TypeScript SDK リファレンス：https://paybond.ai/docs/kit/sdk-reference-typescript
• サポートマトリックス（言語、フレームワーク、Rails）：https://paybond.ai/docs/kit/support-matrix
• パッケージの来歴と検証：https://paybond.ai/docs/kit/package-provenance
• MCP サーバーガイド：https://paybond.ai/docs/kit/mcp-server
• エージェントランタイムのチュートリアル：https://paybond.ai/docs/kit/agent-runtime-tutorial
• TypeScript のサンプルプロジェクト：https://paybond.ai/docs/kit/examples-typescript
• Developer 無料サンドボックスへの登録：https://paybond.ai/signup

リリースの検証

ソースをチェックアウトして作業するメンテナー向けのリリース検証は、このパッケージディレクトリにあります。

npm run verify:release

これにより、テストを実行し、クリーンビルドを行い、パッキングした tarball に不要なファイルが含まれていないかを調べ、パッケージ化した状態のパッケージを使って一時的なコンシューマーアプリをコンパイルします。