Genesis402 by UnyKorn (x402 pay-per-call)

genesis402-mcp

Genesis402：x402 を介した AI エージェント向け従量課金 API です。

これは Genesis402 レール用の MCP サーバーです。DeFi と市場データ、SEC 財務情報、公開データに基づくウォレットおよびトークンのリスクシグナル、ウェブおよびドメイン検索、AI テキストツール、さらに EVM チェーン、Solana、Bitcoin、Stellar、XRP Ledger にまたがるマルチチェーン読み取りに対応した、360 個の従量課金エンドポイントを提供します。

利用した呼び出し分だけを支払います。アカウント、サブスクリプション、API キーは不要です。 料金は呼び出しあたり 0.001 ドルからで、支払い前に表示されます。このパッケージでは、x402 v2 を介して Base 上の USDC で支払います。

デフォルトでは見積もりのみ

デフォルトでは見積もりのみです。支払いを有効にし、価格上限を設定するまでは、署名も支払いも行われません。

初期状態では、すべての有料ツールは価格の見積もりを返して停止します。支払いを有効にするには、GENESIS402_LIVE=1 と GENESIS402_PAYER_KEY の両方を設定する必要があります。その場合でも、GENESIS402_MAX_USD（デフォルトは $0.25）を超える見積もりは支払われず、拒否されます。

価格はレールが決定します。このクライアントは価格を決めず、提示された価格を受け入れるかどうかだけを判断します。

ホスト型エンドポイント（インストール不要）

ストリーミング可能な HTTP に対応した任意の MCP クライアントを https://twin.unykorn.org/mcp に接続してください。カタログ内のすべてのエンドポイントに対して、同じ 22 個のツールを公開します。

• ホスト型 MCP エンドポイント https://twin.unykorn.org/mcp はキーを保持しません。有料ツールは正確な x402 見積もりを返します。
• 支払いには、自分のウォレット（たとえば @x402/fetch または CDP/AgentKit ウォレット）で、その見積もりに対する x402 v2 支払いに署名し、payment_signature を指定してツールを再度呼び出します。
• ヘルスチェック：https://twin.unykorn.org/mcp/health

インストール（ローカル、stdio）

// Claude Desktop: claude_desktop_config.json
// Cursor:         .cursor/mcp.json
{
  "mcpServers": {
    "genesis402": {
      "command": "npx",
      "args": ["-y", "genesis402-mcp"]
    }
  }
}

この設定ではカタログを閲覧して価格を確認できますが、支払いは一切行えません。

支払いを可能にするには：

{
  "mcpServers": {
    "genesis402": {
      "command": "npx",
      "args": ["-y", "genesis402-mcp"],
      "env": {
        "GENESIS402_LIVE": "1",
        "GENESIS402_PAYER_KEY": "0x<a funding key you are willing to spend from>",
        "GENESIS402_MAX_USD": "0.05"
      }
    }
  }
}

数ドル分の USDC を Base 上に保有する専用キーを使用し、メインウォレットは決して使わないでください。

ツール（14）

有料ツールの説明には、起動時にレールの /.well-known/x402 マニフェストから読み込んだ最新の価格が記載されています。そのため、レール上で価格が変更されても、このクライアントが古い価格を表示することはありません。

ツール	費用	機能
genesis402_catalog	無料	価格、タイトル、パス、パラメーターを含むすべてのエンドポイント。最初に呼び出してください。
genesis402_receipt	無料	公開レシートフィードから、IDで有料呼び出しのレシートを取得します。
genesis402_call	エンドポイントごと	カタログ内の任意のエンドポイントを名前で呼び出します。
genesis402_wallet_brief	有料	ウォレットのリスクシグナルを一度の呼び出しで取得します。公開制裁リストの照合、10チェーンのスキャン、アクティビティと概要、証拠ハッシュが含まれます。
genesis402_token_brief	有料	トークンの取引前チェックです。メタデータ、価格、保有者の集中度、ソースの検証、制裁リストのシグナルを取得します。
genesis402_screen_sanctions	有料	公開データに基づく制裁リストのシグナルです。OFAC SDN のデジタル通貨エントリーとコミュニティのブロックリストを確認します。
genesis402_multi_chain_scan	有料	1つのアドレスについて、10の EVM チェーンを一度の呼び出しでスキャンします。
genesis402_defi_yields	有料	15,000以上のプールから DeFi の利回りを取得します。チェーン、プロトコル、トークン、ステーブルコインのみ、最小 TVL で絞り込めます。
genesis402_market_snapshot	有料	主要コイン、または指定した最大25銘柄の価格と24時間・7日間の変動を一度の呼び出しで取得します。
genesis402_sec_financials	有料	SEC XBRL から米国上場企業の報告書記載の財務データを取得します。
genesis402_email_check	有料	メールアドレス／ドメインの到達性を確認します。MX、プロバイダー、SPF、DMARC、使い捨てアドレスのフラグを取得します。
genesis402_whois	有料	RDAP を通じて、ドメインのレジストラー、登録からの経過期間、有効期限、ステータス、ネームサーバーを取得します。
genesis402_extract_json	有料	任意のテキストから指定したフィールドを JSON として抽出します。不明なフィールドは捏造せず、null にします。
genesis402_web_extract	有料	任意の公開ウェブページから、整形済みテキスト、タイトル、見出し、リンクを取得します。
genesis402_prove	有料	SHA-256 ダイジェスト（またはテキスト）を確定済みの支払いに結び付ける、Ed25519 署名付きレシートを作成します。
genesis402_summarize	有料	指定したテキストを要約します。段落、箇条書き、または TL;DR 形式で、20～400語にまとめます。
genesis402_answer_from_text	有料	ドキュメントに基づく回答を1つ返します。レールがテキスト内にあると検証する根拠の引用も含まれます。
genesis402_translate	有料	主要な言語のいずれかに翻訳します。名前、数字、書式は保持されます。
genesis402_paper_search	有料	OpenAlex の学術検索です。関連度順または被引用数順で検索し、オープンアクセスのリンクを取得します。

有料呼び出しの仕組み

1. 無料の検証。 パラメーターは最初に、無料のレールの /__validate に送信されます。見積もりを要求する前に、不正な入力は拒否されます。
2. 無料の見積もり。 支払いのないリクエストは、価格を含む 402 チャレンジを返します。
3. 支払い。 ライブモードの場合に限り、上限額以内で、標準の x402 v2 クライアントを通じて支払います。
4. 結果とレシート。 有料呼び出しごとに署名付きレシートが発行され、レールの公開 レシートフィード に掲載されます。

1回の支払いで実行できるのは1回だけです。同じ支払いを再提示すると 409 が返されます。

制限事項について

• リスクと制裁の結果は、公開データに基づく自動化されたヒューリスティックシグナルです。KYC でも、コンプライアンスの判定でも、法的助言でもありません。いずれのリストにも載っていないことは、問題がないことを意味しません。
• prove は主張を記録するものであり、その真偽を評価するものではありません。レシートチェーンは外部にアンカーされていません。有効なレシートが示すのは、レールがそれを発行し、改ざんしていないことだけであり、レールがチェーンを遡及して作成できなかったことではありません。

環境変数

変数	デフォルト	説明
GENESIS402_ORIGIN	https://twin.unykorn.org	レールのオリジン。
GENESIS402_LIVE	未設定	1 にすると支払いが有効になります。それ以外の値では見積もりのみです。
GENESIS402_PAYER_KEY	未設定	呼び出しの支払いに使う秘密鍵です。ライブモードでは必須です。
GENESIS402_MAX_USD	0.25	1回の呼び出しあたりの厳格な上限です。見積もりとの照合時と署名時に確認します。上限を超える見積もりは拒否されます。値が0、負数、または数値以外の場合、サーバーは見積もりのみの状態を維持します。

コミュニティ

質問、フィードバック、無料の取引相手レポート（/check）：UnyKorn Discord。

テスト

node smoke.mjs      # read-only checks against the live rail; never pays
node boot-test.mjs  # boots over stdio and lists the tools a client would see

UnyKorn LLC（ワイオミング州）。MIT ライセンス。変更履歴：CHANGELOG。 検出：/.well-known/x402 · 領収書：/receipts