Frisk

frisk-mcp

Frisk 用の MCP サーバーです。 エージェントが x402 の支払いを行う前に、支払い相手をスクリーニングします。

screen_payment という 1 つのツールを公開します。このツールは、Frisk の決定論的なチェック（アドレスの妥当性、動的な payTo との照合、トランスポートの安全性、および独自の支出ポリシー）を実行し、理由とともに allow ／ review ／ block を返します。

このツールが適する用途と適さない用途

MCP ツールは、モデルが呼び出しを決定したときに実行されます。モデルがスキップできる支払いチェックは、支払いに署名するコードパス上で同じチェックを行う場合よりも保証が弱くなります。

そのため、次のように使い分けてください。

• ライブラリを使用する — 実際に資金が移動する箇所では、frisk-screen を使用してください。MIT ライセンスで、依存関係がなく、ローカルで実行できます。
• このサーバーを使用する — 検査（「このアドレスへの支払いは安全か？」）や、ライブラリをインポートできないエージェントには、このサーバーを使用してください。

どちらの場合も、Frisk は助言を行うだけです。判定を返しますが、最終的な決定はコード側で行います。資金を保有することはなく、単独で支払いを止めることもできません。

インストール

npx frisk-mcp

MCP クライアントのサーバー設定に、次の内容を追加します。

{
  "mcpServers": {
    "frisk": {
      "command": "npx",
      "args": ["-y", "frisk-mcp"]
    }
  }
}

API キーもアカウントも不要で、ネットワーク呼び出しも行いません。設定がない場合、サーバーはすべてのスクリーニングをマシン上で実行します。

ホステッドモード（任意）

FRISK_API_KEY を設定すると、同じツールがホステッドサービスから応答するようになります。これにより、評判グラフのシグナルが追加され、より高い確信度の判定が返されます。

{
  "mcpServers": {
    "frisk": {
      "command": "npx",
      "args": ["-y", "frisk-mcp"],
      "env": { "FRISK_API_KEY": "..." }
    }
  }
}

ホステッドの利用枠は早期アクセス中です。[email protected] までメールでお問い合わせください。上記の機能はすべて、ホステッドサービスなしで利用できます。

変数	デフォルト	説明
FRISK_API_KEY	未設定	ホステッドスクリーニングを有効にします。未設定の場合は完全にオフラインで動作します。
FRISK_BASE_URL	https://api.tryfrisk.dev	ホステッドエンドポイントを上書きします。

ツール

screen_payment

引数	型	備考
counterparty	文字列、必須	エージェントが支払いを予定しているアドレスです。
endpoint	文字列	支払い額を提示した URL です。平文でのトランスポートをチェックします。
amount	数値	支払い予定の金額です。
asset	文字列	アセットのシンボルです（例：USDC）。
observedPayTo	文字列	エンドポイントが実際に返した payTo です。counterparty と異なる場合、動的な payTo の差し替えが発生しています。
strictness	数値、0～1	0 は許容的、1 は非常に厳格です。デフォルトは 0.3 です。
maxPerCall	数値	1 回の呼び出しに対する支出上限です。
allowedAssets	文字列[]	エージェントが支払いに使用できるアセットです。

verdict、trustScore、confidence、reasons、policyHits、source（lite または hosted）、および allowed を返します。

このツールが行わないこと

Sybil クラスターは検出しません。また、オフラインではアドレスの履歴を参照できないため、lite スクリーニングではこの理由から常に "low" の確信度が報告されます。さらに、支払いの基盤となるプロトコルを修復することもできません。リプレイ、決済の競合、ファシリテーターへの信頼は、署名対象のリクエストではなく x402 自体に関わる問題です。こうした制限については、x402 の支払いで問題が起こる 5 つのケースで説明しています。

ライセンス

MIT