Lumen Agent Utilities

Lumen Works Agent API (x402)

1 つのオリジンに 2 つのリスティングがあります。

• Lumen Pre-Sign Check：POST /v1/tx/explain（$0.002）。EVM トランザクションまたは EIP-712 メッセージに署名する前に使用します。{summary[], flags[], verdict} を looks_ok | review | do_not_sign_unless_intended とともに返します。エージェントのポリシー：do_not_sign_unless_intended の場合は中止し、review の場合はエスカレーションします。**情報提供を目的としており、安全性を保証するものではありません。looks_ok は安全を意味せず、シミュレーションも行いません。**精度の評価セットと既知の制限：ACCURACY.md。MCP：/mcp/presign。
• Lumen Agent Utilities：以下のその他すべてのルート。MCP：/mcp。

信頼に関する条件：サインアップ不要。/v1/free/... は IP ごとに 1 時間あたり 20 回までの無料枠です。課金対象のパスに対する GET／HEAD は 402 の見積もりを返します（決済は実行されません）。呼び出しがエラーになった場合は課金されません。x402 ミドルウェアは、ハンドラーが 400 未満のステータスを返した後にのみ決済を実行するためです。各ルートの Bazaar 拡張機能と /openapi.json に、入力スキーマと実際の出力例（examples.json。test/capture-examples.mjs がライブ環境から取得）が含まれています。node test/validate-bazaar.mjs <base> で検証できます。

統計情報：/v1/stats に含まれるのは匿名化された集計情報のみです（UA ファミリー、日ごとにソルトを変更する IP ハッシュから得られる 1 日あたりのユニーク数、30 日間の保持）。STATS_GIST_ID と STATS_GIST_TOKEN（gist のみを対象とするトークン）が設定されている場合、デプロイ後も保持されます。それ以外の場合はメモリ内に保持されます。

エージェント向けの従量課金ユーティリティ。x402 を介して Base メインネット上で、呼び出しごとに 0.001～0.002 USDC がかかります（exact scheme、PayAI のパブリック facilitator）。作者：Dan（Dansgit2b）。初期段階のものであり、監査は受けていません。

エンドポイント（POST JSON）	内容
/v1/x402/lint {header}	x402 PAYMENT-REQUIRED／SIGNATURE／RESPONSE のデコードと lint
/v1/eip712/decode {typedData}	ドメインセパレーター、ダイジェスト、リスクに関する注記
/v1/calldata/decode {data, signature?}	セレクター、openchain／4byte の検索、デコードされた引数
/v1/web/markdown {url, fullPage?, maxChars?} — $0.001	公開ページ → 整形済み Markdown（Readability）とメタデータ。JS のレンダリングは行いません。
/v1/web/unfurl {url} — $0.001	最終 URL、ステータス、タイトル、説明、OG 画像、canonical、favicon
/v1/evm/address {address}（0x または ENS）— $0.002	Ethereum と Base：ENS とレコード、EOA／コントラクト／7702、残高、USDC／USDT、ERC-20 情報（パブリック RPC）
/v1/domain/lookup {domain} — $0.002	DNS（DoH）A／AAAA／MX／NS／TXT／CAA、SPF／DMARC、RDAP 登録事業者／作成日／有効期限、ドメインの経過年数

無料枠：同じパスを /v1/free/... の下で利用できます（IP ごとに 1 時間あたり 20 回）。検出用エンドポイント：/、/.well-known/x402、/openapi.json、/llms.txt。 payTo：0xee9790cB3960952F585379F831a89b4e00B4029A。

エンドツーエンドの検証（ローカル実行、2026-10-10）：Base で課金対象の呼び出しが決済されました。tx 0xff4af45df7caeef958b77700e96ba94e5ed37d3bac6e8cf40d6528a9497d77d4。

デプロイ：Render（render.yaml、無料プラン）または任意の Docker ホスト（Dockerfile）。PUBLIC_BASE に公開オリジンを設定してください。シークレットは不要です（サーバーが受け取るのは支払いのみです）。ライセンスは MIT です。

MCP サーバー

リモート MCP（ストリーミング可能な HTTP、ステートレス JSON）：https://lumenworks-x402-decoder.onrender.com/mcp。ツールは x402_lint、eip712_decode、calldata_decode、web_markdown、url_unfurl、evm_address_lookup、domain_lookup です。無料枠は IP ごとに 1 時間あたり 20 回のツール呼び出しです。それ以降、ツールは対応する課金対象 HTTP エンドポイントの x402 支払い要件（0.001～0.002 USD）を返します。

Celo

X402_CELO_API_KEY（x402.celo.org のダッシュボードから取得）が設定されている場合、すべての課金対象ルートで Celo 上の USA₮ と USDC（eip155:42220）も利用できます。決済は Celo のホスト型 facilitator（api.x402.celo.org）を通じて行われます。

無料の x402 決済安全性チェック

POST /v1/x402/safety-check（MCP ツール x402_payment_safety_check）— 決済前に実行する決定論的なチェックです。本文：{url?, method?, payment_required?, expected_pay_to?, expected_network?, max_price_usdc?, listed_price_usdc?, facilitator_url?, client_config?}。未決済の 402 を取得し（SSRF 対策済み）、ok | review | do_not_pay と、以下のチェック結果を返します：HTTPS／稼働状況／レイテンシ、payTo の有効性／チェックサム／不一致、不明なアセット／ネットワーク、上限価格および表示価格との比較、タイムアウト／リプレイ期間、複数の payTo、不明なファシリテーター、クライアント設定における支出上限／冪等性の欠落。データは保存されません。秘密鍵のように見える入力は拒否されます。IP ごとに 1 時間あたり 30 回です。

予定（未実装）：価格／payTo／アセットの変更を通知する継続的な監視。無料のウェイトリスト：POST /v1/monitoring/waitlist {endpoint_url, contact?}（IP ごとに 1 時間あたり 5 回）。開始日は未定です。無料ホストではメモリ／ログのみに保存されるため、再起動時に失われる可能性があります。

統計

GET /v1/stats — 前回の再起動以降の匿名のメモリ内カウンター：エンドポイントごとの呼び出し数、未決済の 402 と決済済みの決済（コンバージョン）、大まかなユーザーエージェントの分類。IP アドレスや本文は保存されません。

v1.3：署名前の説明＋公開データツール

エンドポイント（POST）	価格	MCP ツール	上流（無料、キー不要）
/v1/tx/explain	0.002	explain_before_sign	calldata（openchain/4byte）＋ EIP-712、リスクフラグ
/v1/pubmed/search	0.001	pubmed_search	NCBI E-utilities
/v1/arxiv/search	0.001	arxiv_search	arXiv API
/v1/sec/filings	0.001	sec_filings	SEC EDGAR（SEC のポリシーに従い、連絡先メールアドレスを SEC_USER_AGENT に設定してください）
/v1/weather/forecast	0.001	weather_forecast	Open-Meteo（CC BY 4.0）
/v1/polymarket/markets	0.001	polymarket_markets	Polymarket Gamma（読み取り専用データ）

無料枠：/v1/free/<path> または MCP、IP ごとに 1 時間あたり 20 回。

ファシリテーター

CDP_API_KEY_ID と CDP_API_KEY_SECRET が設定されている場合、Coinbase の CDP ファシリテーターが最初に使用されます。これを経由した決済によって、サービスが x402 Bazaar にインデックス登録されます。PayAI ファシリテーターはフォールバックとして引き続き登録されています。CDP キーがない場合は、従来どおり PayAI がすべてを処理します。