Lumi Trades: x402 seller checks and test-buys

lumi-trades-mcp

Lumi Trades 用の MCP サーバー（stdio）です。エージェントが x402 の販売者に支払う前に、無料の署名付き許可／警告／ブロック判定を行う Lumi Check を提供します。この判定は、XRPL、Base、Stellar 上で Lumi 自身が有料のテスト購入を行った結果に基づいています。また、Institutional & Policy Brief（機関・政策ブリーフ）（毎日更新）や暗号資産の市場データに加え、別の製品ラインとして、50 銘柄を対象とした Lumi Trades の市場分析（教育目的であり、助言ではありません）も提供します。Claude Desktop、Cursor、Claude Code、Cline、Windsurf、その他すべての MCP クライアントで動作します。有料ツールは、お手持ちのウォレットを使い、x402 経由で呼び出しごとに支払います。Base 上の USDC（ガス代不要）、または XRP Ledger 上の XRP／RLUSD／USDC が利用できます（API は Stellar 上の USDC にも対応していますが、このパッケージで支払えるのは Base または XRP Ledger のみです）。 API キーもアカウントも不要です。有料ツールを呼び出すたびに、マシン上でローカルに署名された少額の支払いが発生します。

分析および教育のみを目的としています。金融アドバイスや、購入、売却、保有を推奨するものではありません。分析結果は機械的なモメンタム／トレンドの要約であり、予測ではありません。

Lumi Trades の市場分析（lumi_signal、lumi_lite、lumi_scan、lumi_levels、lumi_slate）：情報提供のみを目的としており、投資アドバイスではありません。Lumi は実際の資金で取引を行いません。

インストールせずに利用することもできます： 同じツールは https://api.lumitrades.io/mcp（Streamable HTTP）からもリモートで提供されており、リモート MCP サーバーの URL を指定できるクライアントから利用できます。リモートコネクターにはウォレットがないため、有料ツールは価格と支払い方法を返します。有料ツールの支払いをお手持ちのウォレットから自動で行いたい場合は、このパッケージを使用してください。

ツール

一般（無料）

ツール	有料？	価格（USD）	内容
lumi_catalog	無料	–	エンドポイント、現在の価格、このサーバーのウォレットと支出上限
lumi_samples	無料	route?	各有料製品の省略版サンプル。USD 価格と完全な URL を記載
lumi_coins	無料	–	50 銘柄すべてを一覧表示。全銘柄のトレンド分析と、ウォッチリスト／主要 13 銘柄（XRP XLM HBAR XDC AXL ZBCN SHX BTC ETH DOGE ADA LINK SUI）のみ参考ゾーンを提供
lumi_quote	無料	–	支払わずに、任意の有料パスの x402 見積もりを取得

Lumi Trades の販売者チェック（x402）

ツール	有料？	価格（USD）	提供内容
lumi_verdict	$0.01	url payTo? amount?	支払い前に1つのラベルを提示します。/v1/check と同じデータと署名を使用します：checks_passed（最近のチェックで問題なし）／check_first（先にチェック）／checks_failed（最近のチェックで問題あり）／no_data（データ不足）。日付、証拠の対象期間、サンプル数、理由コード、証拠および異議申し立てへのリンクも含まれます。Lumi に支払っても結果は変わりません
lumi_vendor_scores	無料	url? domain? payTo? vendor_id?	支払い前に、任意の x402 販売者を検索できます：ティア（カタログ登録済み／見積もり確認済み・信頼度低／テスト購入済み）、直近の無料 402 見積もりチェック、Bazaar の掲載情報に対する価格と payTo の照合、オンチェーンのテスト購入証拠。引数なしの場合は、Lumi が厳選した販売者スコアを返します
lumi_seller_monitoring	無料	enrollment_id?	販売者のモニタリングプラン（エンドポイントごと・30日あたり：Watch $5、Watch Plus $12、Watch Pro $20、エンドポイント10件以上は20％割引、または3期間分の前払いで10％割引。併用不可。Audit は1回限りで $99、Watch ティアは無料、Watch Plus は14日間のトライアル）、登録手順を確認できます。ID を指定すると、その販売者の公開エントリーとバッジを表示します。支払ってもスコアは変わりません
lumi_trust_feed	無料	–	Trust データフィードのプラン（無料キーは月1,000回の検索、Feed は30日あたり $99、Feed Pro は30日あたり $199）とライセンス条項
lumi_check	無料	url? pay_to? amount_usd? network?	任意の x402 販売者に支払う前の Lumi Check：理由、販売者のスコア、最新レポートへのリンクとともに、許可／警告／ブロックを提示します。Lumi が署名し、ローカルで検証されます。送信されるのは URL のオリジンとパスのみです。フェイルオープン：2.5 秒以内に Lumi に接続できない場合は警告します
lumi_scan_seller	無料	url	x402 販売者の 402 見積もりを支払いなしで取得し、ローカルの上限に基づくテスト購入のドライラン計画も提示します
lumi_report_receipt	無料	endpoint network tx_hash …	すでに行った購入のレシートに署名します。submit: true はティア2の共有機能です。デフォルトでは無効で、LUMI_SHARE_RECEIPTS=1 または lumi-scan sharing on が必要です。支払いのチェーンとトランザクション ID を共有します。これらはオンチェーンで公開されており、支払いに使ったウォレットと関連付けられる可能性があります。検証済みレシートで獲得できるのは公開バッジのみです
lumi_trust_check	有料	$0.02	これから支払う x402 URL の支払い前チェック：掲載情報および Lumi の観測結果と payTo／価格が一致するか確認します。url は必須です
lumi_vendor_report	有料	$0.02	Lumi の信頼リストにある x402 ベンダー1社の全観測履歴：すべての見積もりチェック（90日間）と、有料テスト購入（tx hash および配信の成否）、レイテンシ統計と傾向、稼働率、エージェントのレポート、ベンダーの返信、信頼度ラベルを確認できます。vendor_id は必須です

市場データ

ツール	有料？	価格（USD）	提供内容
lumi_brief	有料	$0.02	本日の市場ブリーフ（BTC、CoinMarketCap Fear & Greed、値上がり銘柄、重要な価格水準、円、イベント、ニュース。取引プランは含まれません）。Markdown 形式にするには format: "md" を指定します
lumi_market	有料	$0.02	BTC とマクロ環境、および市場の広がり
lumi_macro_yen	有料	$0.01	USD/JPY、日経平均、155付近のキャリートレードリスク、日本のイベント
lumi_sentiment	有料	$0.005	Fear & Greed、ファンディングの状況、OI、ドミナンス、市場の広がり
lumi_events	有料	$0.005	出典付きの今後のマクロ／暗号資産イベントと注目材料
lumi_funding	有料	$0.003	OKX に上場している Lumi の全コインの無期限先物ファンディングレート（8時間換算、年率換算、平易な解説付き）
lumi_fear_greed	有料	$0.003	CoinMarketCap Fear & Greed の現在値と昨日／先週／先月の値、年間の最高値／最低値、30日間の推移
lumi_events_48h	有料	$0.003	今後48時間以内（UTC と米国中部時間）に予定されていること、その重要性、出典
lumi_institutional_brief	有料	$0.10	日次の機関・政策ブリーフ：BIS、IMF、米国財務省／規制当局、JPMorgan、SBI、Cross River、Securitize、R3 などの動向を XRP、XLM、XDC、QNT、AXL、HBAR に関連付けて提示します（確認済みの関連と間接的な関連を出典付きで区別）。Markdown 形式にするには format: "md" を指定します。デフォルトの上限（0.30 USD／0.25 XRP）内で利用できます
Lumi Trades の市場分析（情報提供のみであり、投資助言ではありません。Lumi は実際の資金を取引しません。）

ツール	有料？	価格（USD）	内容
lumi_signal	有料	$0.01	1 つのコインのモメンタム／トレンドの方向性（強気／中立／弱気）とスコア（1h／4h／1d＋指標）
lumi_levels	有料	$0.01	1 つのコインのチャート上の参考ゾーンと解説
lumi_scan	有料	$0.02	市場全体のスクリーニング：時価総額上位49銘柄について、モメンタム／トレンドの方向性、スコア、1h RSI、価格、24時間の変動率をスコアの高い順に表示
lumi_lite	有料	$0.004	1 つのコインの簡易な概要：ラベル、スコア、1h／4h／1d のラベル、価格、24時間の変動率
lumi_slate	有料	$0.02	現在のウォッチリストをモメンタム／トレンドの方向性として表示（エントリー、ストップ、目標値、レバレッジは含みません）

支払い方法の優先順位：1. Base 上の USDC（ガス代不要、EVM_PRIVATE_KEY）、2. XRP Ledger（XRPL_SEED）： RLUSD または USDC は同じ USD 価格で、XRP はリアルタイムの XRP/USD レートで決済します（呼び出しごとに提示され、0.0001 XRP 単位で切り上げられます）。 価格は各402見積もりからリアルタイムで取得されます。表の価格は目安です。データを受け取った場合にのみ支払います。データが欠損しているか古い場合、API は見積もりを拒否するため（503、「Not charged.」）、データなしで支払いが確定することはありません。

インストール

Node 20 以上が必要です。npm の lumi-trades-mcp として、また io.github.cypher-osiris/lumi-trades-mcp として official MCP Registry で公開されています。

npx -y lumi-trades-mcp

Claude Desktop／Cursor／任意の MCP クライアント（mcpServers JSON）

{
  "mcpServers": {
    "lumi-trades": {
      "command": "npx",
      "args": ["-y", "lumi-trades-mcp"],
      "env": {
        "EVM_PRIVATE_KEY": "0x...your Base agent wallet key (holds USDC, no ETH needed)...",
        "LUMI_MAX_USD_PER_CALL": "0.30",
        "LUMI_SESSION_BUDGET": "1"
      }
    }
  }
}

代わりに XRP Ledger で支払う場合は、EVM_PRIVATE_KEY の代わりに "XRPL_SEED": "sEd..." を設定します（必要に応じて "LUMI_PAY_ASSET": "RLUSD" または "USDC" を指定できます。デフォルトは XRP です）。

クローンから実行する場合は、mcp/ で npm install を実行した後、"command": "node", "args": ["/absolute/path/to/lumi-api/mcp/src/index.js"] を指定します。 Claude Code の場合：claude mcp add lumi-trades -e EVM_PRIVATE_KEY=0x... -- npx -y lumi-trades-mcp（または -e XRPL_SEED=sEd...）。

ウォレットがなくても無料ツールは利用でき、有料ツールは支払いの代わりに価格の見積もりを返します。

独自コードから Lumi Check を利用する（x402／MCP フック）

import { lumiCheckHooks } from "lumi-trades-mcp/src/check.js";
const { lumi, x402Hook, mcpHook } = await lumiCheckHooks();   // options: { failMode: "open"|"closed", timeoutMs, publicKeys }

x402Client.onBeforePaymentCreation(x402Hook);   // @x402 core: returns { abort: true, reason } on "block"
mcpClient.onPaymentRequired(mcpHook);           // @x402/mcp: returns { abort: true } on "block" (checked by payTo)
const v = await lumi.check({ url, payTo, amountUsd: 0.01 }); // { decision, reasons, score, link, verified }

デフォルトではフェイルオープン（タイムアウトまたは検証できない回答の場合は warn となり、支払いは続行されます）で、タイムアウトは2.5秒です。代わりに処理をブロックするには、failMode: "closed" を設定します。Lumi に支払っても、販売者のスコア、ティア、ランキング、バッジは変わりません。アダプターは npm の lumi-check（Apache-2.0）から提供されます。スコアリングと検証は Lumi のサーバー上で行われます。

このキットが共有する内容：ユーザーが許可するまでは何も共有しません。 lumi-scan CLI は、最初のチェック後に一度だけ確認します（「Lumi の公開信頼リストの改善に役立てるため、結果を共有しますか？ [Y/n]」）。MCP サーバーでは確認できないため、ここでは共有はオフのままで、stderr にヒントが1つ出力されます。有効にするには LUMI_CHECK_TELEMETRY=on または lumi-scan telemetry on を設定します。Tier 1 では、有料の呼び出し後に匿名の配信結果のみを共有します。共有されるのは、販売者のホスト、配信の成否、概要レベルのステータスクラス、ランダムな使い捨てトークンです。ウォレット、金額、トランザクションハッシュ、クエリ文字列、固定IDは共有されません。共有によってスコアが変わることはありません。Tier 2（デフォルトではオフ）では、完全な署名付きレシートを送信します。各レシートで支払いに使用したチェーンとトランザクションIDが共有されます（金額やウォレットのフィールドはありません）。トランザクションIDはオンチェーンで公開されており、支払いに使用したウォレットと関連付けられる可能性があります。貢献者に付与されるのは公開バッジのみで、金銭的価値はありません。キットの README をご覧ください。

設定（環境変数）

変数	デフォルト	説明
EVM_PRIVATE_KEY	–	EIP-3009 認証を通じて USDC で支払う、お使いの Base ウォレットの 0x 秘密鍵です（ガス代不要：ファシリテーターがガス代を支払います）。メモリ内にのみ保持され、ログへの記録、モデルへの返却、外部への送信は行われません（送信されるのは署名のみです）。残高の少ない専用のエージェントウォレットを使用してください。
XRPL_SEED	–	支払いに使うお使いの XRPL ウォレットのシードです。メモリ内にのみ保持され、ログへの記録、モデルへの返却、外部への送信は行われません（支払いはローカルで署名され、API が受け取るのは署名済みのデータのみです）。残高の少ない専用のエージェントウォレットを使用してください。
LUMI_PAY_ASSET	XRPL_SEED が設定されている場合は XRP、それ以外は BASE_USDC	BASE_USDC（Base 上の USDC）、または XRP Ledger（XRPL）上の XRP、RLUSD、USDC（XRPL のステーブルコインにはトラストラインと残高が必要です）
LUMI_MAX_XRP_PER_CALL	0.25	この金額を超える XRP の見積もりを拒否します
LUMI_MAX_USD_PER_CALL	0.30	この金額を超えるステーブルコイン（Base または XRPL）の見積もりを拒否します。拒否メッセージには、この変数名と必要な値が表示されます
LUMI_SESSION_BUDGET	1	サーバープロセスごとの支出上限額（支払い資産単位）
XRPL_NETWORK	xrpl:0	xrpl:0 はメインネット、xrpl:1 はテストネットです
LUMI_API_URL	https://api.lumitrades.io	API のベース URL
LUMI_EXPECTED_PAY_TO	Lumi の公式 API 上のウォレット：rM8kmmnz5qPMg7V3r7SHYXgDGvm8PhzLvM（XRPL メインネット）、0x5E617bac19912e6d212CB303ae84655E9E203532（Base）	他のアドレスへの支払いを拒否します
LUMI_CHECK_API	LUMI_API_URL	lumi_check のベース URL
LUMI_KIT_HOME / LUMI_KIT_CONFIG	~/.lumi-scanner-kit/config.json	Kit の設定（保存済みの共有に関する回答、テレメトリー、共有の切り替え設定）
LUMI_CHECK_TELEMETRY	off（ユーザーが同意するまで）	on にするとレベル 1 の結果レポートを有効にし、off にすると無効にします。保存済みの回答より優先されます
LUMI_SHARE_RECEIPTS	off	1 にするとレベル 2 の領収書送信を有効にします
LUMI_CONTRIB_KEY_FILE	–	レベル 2 の送信用コントリビューターキー（lumi-scan keygen）
XRPL_WS_URL	wss://xrplcluster.com / wss://testnet.xrpl-labs.com	自動入力と署名に使うレジャー接続先

安全対策：署名の前に、サーバーはネットワーク、スキーム、資産、支払先、1 回あたりの上限、セッション予算を確認します。いずれかに問題があれば、署名は行いません。支払いを伴う結果には、オンチェーン取引ハッシュが必ず含まれます。

テスト

npm test                         # spend-cap / payee / settings unit tests + a mocked Base USDC payment through @x402/fetch
node scripts-e2e-testnet.mjs     # testnet only: real x402 payments through MCP against a local testnet API (see the file header)

2026 年 10 月 22 日のテストネット実行（MCP stdio 経由、XRPL Testnet 上の x402、すべて tesSUCCESS）：lumi_sentiment 9137C1AE…、lumi_macro_yen 38DDADD0…、lumi_events EBD235D3…、lumi_trades 661D8180…、lumi_brief（Markdown）16F1BEFA…。

ライセンス

MIT