Sentinel Payment Boundary Tools

Sentinel Payment Boundary Tools

公開決済メタデータ向けの、決定論的な無料の事前チェックツールを2つ、ローカルで公開見積依頼の下書きを作成するツールを1つ、さらに Sentinel Recovery の公開サービスカタログと見積依頼の仕様を備えた、読み取り専用の stdio MCP サーバーです。

ソースのバージョン 0.4.1 では、prepare_agent_payment_boundary_quote_request と固定された x402 v2 exact-EVM EIP-3009 安全プロファイルを維持しながら、公開見積依頼の下書きに使う URL の検証とサービスカタログのガードを強化しています。チェックサム付きのバージョン管理された MCPB アーティファクトは、GitHub Releases ページで公開されています。npm では公開されていません。公式 MCP Registry 名は io.github.TerminallyLazy/sentinel-recovery-services です。公開されたバージョンを信頼する前に、最新の mcp/server.json、リリースのチェックサム、Registry のレコードを確認してください。GitHub Pages サイトは静的サイトであり、リモート MCP エンドポイントではありません。

ツール

• preflight_agent_payment_boundary は、合計 100 KiB までのインライン公開 JSON、Markdown、またはテキスト文書を1つまたは2つ分析します。
• リクエストと決済の権限、支払者ポリシー、受取側と送金側のウォレット権限、カストディ／署名／支出、正規の決済タプル、見積の有効期限、リプレイ処理、レシートの状態、機微なウォレット入力、寄付の分離、メタデータの完全性を対象とした、固定の11項目のチェックを実行します。
• 結果は決定論的な clear、ambiguous、または missing で、範囲を制限したロケーター、正規化された証拠マーカー、リスク、修正方法を含みます。提供された文章がモデルから見える出力にコピーされることはありません。
• リクエスターが制御する URL の取得、文書内容の実行、リクエストの送信、ウォレットへの接続、資金の移動は行いません。
• clear は、必要な認識済み構造化宣言が存在し、提供された内容のうちモデル化されていないものが観測されなかったことを意味します。これは認証ではなく、実装の動作を検証するものでもありません。clear になり得る各チェックでは、未知のフィールドまたは許可リストにない自由形式の値があると、安全かどうかを推測せず、宣言を保守的に ambiguous へ格下げします。外部ダイジェスト URL は、オフラインの事前チェックで取得も信頼も行わないため、引き続き ambiguous です。完全なレビューでは、提供された完全性の証拠を別途検証できます。
• preflight_x402_v2_payment_required は、インラインでデコードされた x402 v2 PaymentRequired オブジェクトを1つだけ、固定の9項目のチェックで分析します。固定された閉世界の Sentinel プロファイルのみを受け付けます。すなわち、exact、正規形式の eip155:<chain-id>、EIP-3009 の送金メタデータ、完全かつ一意な選択肢が1～64個、正の uint256 アトミック単位額、1～86,400秒のタイムアウトです。
• x402 プロファイルは、意図的に x402 コアより厳格です。構造上 clear であっても、チェーンの実在、トークンが申告どおりに動作すること、EIP-712 ドメインの正しさ、受取人がアドレスを制御していること、支払者ポリシーが決済を許可していること、署名の有効性、決済の完了、またはレシートの存在を証明するものではありません。Permit2、ERC-7710、空でない拡張機能、その他のモデル化されていない内容は、黙って受け入れず、未対応または ambiguous として報告されます。
• prepare_agent_payment_boundary_quote_request は、認証情報、クエリ文字列、フラグメント、非公開ホストを含まない一意な公開 HTTPS 文書 URLを1つまたは2つと、任意の公開リクエスト詳細を受け付け、対象範囲が固定された Agent Payment Boundary Review 用の、完全な未送信の公開 GitHub issue 下書きを作成します。
• 下書き作成ツールはリクエストをローカルで整形します。提供された URL の取得や検証、ネットワークリクエスト、認証情報の使用、issue の送信、決済の承認、決済手順の記載、サービス利用権の作成は行いません。

リソース

• sentinel://services/catalog は、最新の services.json を読み込み、検証します。
• sentinel://services/quote-request-contract は、最新の service-request.json を読み込み、検証します。

リソースの読み取り、事前チェック、またはリクエスト草案の準備によって、資金が移動することはありません。草案作成ツールは、完全な公開 GitHub リクエストパケットを返しますが、何も送信せず、支払いを承認せず、サービスを利用する権利も作成しません。リクエスト送信者は、自身に委任されたコミュニケーションポリシーの範囲内で送信するかどうかを引き続き管理します。Sentinel の担当者は、完全な書面による見積もりを発行するかどうかを引き続き管理し、その後の支払いは支払者自身のポリシーによって管理されます。サーバーが認証情報、キー、署名、ウォレット接続、資産保管、またはウォレットの制御を要求することはありません。任意の $49 のレビューは、見積もりを先に提示する方式です。無料ツールを使用しても、支払い義務は発生しません。

インストールと検証

リポジトリのルートから実行します：

npm ci --prefix mcp --ignore-scripts
npm test --prefix mcp
npm audit --prefix mcp --audit-level=high
npm run pack:check --prefix mcp

クライアントの設定

例のパスを、検証済みのチェックアウトへの絶対パスに置き換えます：

{
  "mcpServers": {
    "sentinel-recovery-services": {
      "command": "node",
      "args": ["/absolute/path/to/sentinel-recovery-support/mcp/server.mjs"]
    }
  }
}

クライアントは、stdio 経由で node mcp/server.mjs を起動します。サーバーは MCP プロトコルメッセージのみを stdout に書き込み、起動時のエラーは stderr に出力します。

ネットワークと検証の境界

• ハードコードされた 2 つの正規 HTTPS URL のみを取得します。
• 2 つの事前チェックツールはインラインコンテンツのみを受け付け、ネットワークリクエストを行いません。
• リクエスト草案作成ツールは、呼び出し元から渡された公開 HTTPS URL を受け付けますが、クエリー文字列、フラグメント、認証情報を含む URL、公開されていないホストは受け付けません。また、それらを取得したり、利用可能かどうかを確認したり、認証情報を使用したり、ネットワークリクエストを行ったり、生成された公開 GitHub issue の草案を送信したりすることはありません。
• 重複したオブジェクトキーを含む JSON は評価前に拒否されます。認識されたフィールドとコンテナーは、制限された型と値の範囲に一致する必要があります。
• リクエストには GET を使用し、タイムアウトは 10 秒、レスポンスの上限は 256 KiB です。
• レスポンスは、想定される最小限のコントラクトの形状に一致する JSON オブジェクトである必要があります。
• 上流でエラーが発生した場合、正規 URL を含む、対処方法がわかる MCP エラーを返します。
• 環境変数、API キー、インストールスクリプト、ウォレットへのアクセスは不要です。

このリポジトリでは現在、汎用的なコードライセンスを公開していないため、パッケージは UNLICENSED です。ソースをインストールまたは実行しても、金銭に関する権限が付与されることはありません。