RAEN x402 Gateway

raen-mcp

RAEN の有料 x402 サービス向け Model Context Protocol サーバーです。 サービスごとに MCP ツールを 1 つ用意しており、各呼び出しで x402 プロトコルを介して Base メインネット上の USDC マイクロペイメントを決済します。

稼働中のゲートウェイ（ストリーミング可能な HTTP）：https://raen-mcp-gateway.fly.dev/mcp 認証：Authorization: Bearer <MCP_GATEWAY_KEY>（ゲートウェイキーが必要です。ツール呼び出しには実際の USDC が使用されます。）

ツール

ツール	サービス	価格（USDC、Base）	入力
raen_law_lookup	royal-ruby	$0.05	{topic} — FCRA/FDCPA/TILA/州のUDAPに関する引用
raen_ticker_analysis	tradingagents	$0.05	{ticker, date?} — 合成的な市場コンセンサスのデモ（投資助言ではありません）
raen_dispute_letter	dispute-forge	$0.75	{creditor, reason} — FCRA異議申立書 + SVG証明書
raen_image_generate	nanobanana	$0.01	{prompt, aspectRatio?} — AI画像、base64 PNG
raen_contract_analysis	contract-eye	$0.05	{text, focus?} — 契約のリスクスコア + フラグ付き条項

実行方法

Stdio（ローカル MCP クライアント / Smithery）

{
  "mcpServers": {
    "raen-mcp": {
      "command": "node",
      "args": ["src/index.js"],
      "env": { "RAEN_PAYER_KEY": "0x...private key of a Base-mainnet USDC wallet..." }
    }
  }
}

ストリーミング可能な HTTP（リモート）

RAEN_PAYER_KEY=0x... MCP_GATEWAY_KEY=<random-secret> node src/http.js   # :8080/mcp

任意の MCP クライアントから接続できます：Authorization: Bearer <key> を付けて POST https://raen-mcp-gateway.fly.dev/mcp を送信します。

Fly.io へのデプロイ

flyctl apps create raen-mcp-gateway
flyctl secrets set -a raen-mcp-gateway RAEN_PAYER_KEY=- MCP_GATEWAY_KEY=<secret>
flyctl deploy --remote-only

決済の仕組み

ツールハンドラーは @x402/fetch + @x402/evm（v2）の wrapFetchWithPayment(fetch, x402Client) を呼び出します。最初のリクエスト → PAYMENT-REQUIRED チャレンジヘッダー付きの HTTP 402 → クライアントが EIP-3009 transferWithAuthorization に署名 → ファシリテーター経由で決済 → 製品のペイロードを含む最終 HTTP 200。支払者のキーは RAEN_PAYER_KEY（環境変数）からのみ取得され、ログへの記録やコミットはされません。

エンドポイント（稼働中のマニフェスト）

リポジトリファミリー

• エージェント向けテンプレート：raen-agent-kit — LangChain/LangGraph + CrewAI。このゲートウェイに数分で接続できます。
• すべてのエンドポイント向け統合レシピ：x402-cookbook — 402チャレンジフロー、初回無料の課金とリベート、ゲートウェイ設定に使える curl/Python のコピー＆ペースト用レシピです。

各エンドポイントのパスとスキーマは、サービスの /.well-known/x402.json と照合して検証済みです。

• https://royal-ruby-x402.fly.dev/.well-known/x402.json
• https://tradingagents-x402.fly.dev/.well-known/x402.json
• https://dispute-forge-x402.fly.dev/.well-known/x402.json
• https://nanobanana-x402.fly.dev/.well-known/x402.json
• https://contract-eye-x402.fly.dev/.well-known/x402.json

テストの証跡（2026年11月9日）

• npm run test:paid → HTTP 200。$0.05 の法律情報検索で実際の引用（15 U.S.C. § 1681i、15 U.S.C. § 1692g）を取得。
• ストリーミング可能な HTTP 経由の MCP クライアント（SDK）→ tools/list で 5 つすべてのツールが返され、デプロイ済みゲートウェイ経由の tools/call raen_law_lookup → 引用を含む HTTP 200。

情報提供のみを目的としており、法律または金融に関する助言ではありません。