Treasury Risk Analyzer

treasury-risk-mcp

Treasury Risk Analyzer 用の MCP サーバーです。AI トレジャリーエージェントや CFO エージェント向けに、決定論的な財務判断サービスを提供します。トレジャリーリスク、為替エクスポージャー、流動性予測に加え、「この支払いを今日、安全に実行できますか？」という問いに対応します。

各呼び出しの料金は、x402 を介して Base 上の USDC で支払います。アカウント、API キー、サブスクリプションは不要です。エージェントは自身のウォレットから呼び出しごとに支払い、入力が有効な場合にのみ課金されます。

ツール

ツール	料金	回答する内容
describe_service	無料	サービスの機能、料金、支払いが設定されているかどうか
get_example_input	無料	有料ツールで使用できる有効な入力例
run_demo	無料	固定のサンプルデータで有料ツールを実行し、実際の完全な出力を返します（デフォルト：「今日、750,000 EUR の請求書を支払えますか？」）
treasury_risk	$0.10	ボラティリティ、シャープ／ソルティノ／カルマー比、VaR／CVaR、HHI 集中度、リスク寄与度、相関ストレステスト
fx_exposure	$0.25	通貨別のグロス／ネットエクスポージャー、ナチュラルヘッジ、為替ストレスシナリオ、ヘッジの優先順位
liquidity_forecast	$0.50	日次キャッシュ予測、最低現金残高とその日付、バッファー違反、流動性ステータス、任意の DSO／DPO／DIO
treasury_decision	$2.00	流動性、為替、リスクを組み合わせた、支払いに対する PAY／REVIEW／DO_NOT_PAY の判定と信頼度スコア

数値の計算に LLM は使用しません。すべての指標は決定論的で、応答の methodology に記載されています。

インストール

Claude Desktop（claude_desktop_config.json）、Cursor、または任意の MCP クライアント：

{
  "mcpServers": {
    "treasury-risk": {
      "command": "npx",
      "args": ["-y", "treasury-risk-mcp"],
      "env": {
        "X402_PRIVATE_KEY": "0x…",
        "MAX_PAYMENT_USD": "2.00"
      }
    }
  }
}

Claude Code：

claude mcp add treasury-risk -e X402_PRIVATE_KEY=0x… -e MAX_PAYMENT_USD=2.00 -- npx -y treasury-risk-mcp

変数	デフォルト	説明
X402_PRIVATE_KEY	(なし)	USDC を保有する Base ウォレットの秘密鍵です。設定しない場合、有料ツールは入力を検証して料金を返すだけです。
MAX_PAYMENT_USD	2.00	呼び出しごとの上限額です。この金額を超える料金のツールは、署名を行う前に拒否されます。
TREASURY_API_URL	本番用 URL	サービス URL を上書きします。

ウォレットの安全性： 少額の USDC のみを保有する専用ウォレットを使用してください。鍵は、お使いのマシン上の MCP プロセス内に保持されます。鍵は、サービスが要求する正確な料金分の EIP-3009 USDC 送金に署名するためにのみ使用され、MAX_PAYMENT_USD を超えることはありません。ファシリテーターが送金を実行するため、ガス代用の ETH は不要です。

支払いの仕組み

1. ツールは入力を API に送信します。入力が無効な場合は無料で 400 が返され、課金されることはありません。
2. 入力が有効な場合は、料金とともに 402 Payment Required が返されます。
3. サーバーはその料金分の USDC 承認に署名し、リクエストを再試行します。
4. Base 上で支払いが決済され、分析結果が _payment の領収情報（トランザクションハッシュ、支払者、ネットワーク）とともに返されます。

制限事項

• 出力は分析および意思決定支援であり、投資助言ではありません。支払いを実行することはありません。
• 分析対象は提供されたデータのみです。市場データは取得しません。
• HTTP API を直接呼び出すこともできます。OpenAPI 仕様は /openapi.yaml および /openapi.json にあります。