Alien Probe who

alienprobe-who-mcp

あらゆるエージェントに、1つの法人情報（LEI、法人名、管轄区域、法人ステータス、登録ステータス）を x402 経由で呼び出しごとに Base 上で $0.05 USDC で提供する MCP サーバーです。登録も、API キーも、アカウントも不要です。ウォレットがアカウントです。

ツールは2つあります。

ツール	費用	機能
who_terms	無料	表示価格、ネットワーク、支払先、対象範囲を返します。支払いは発生しません。ウォレットなしで利用できます。
who	$0.05、実際の支払い	法人情報を返します。見つからない場合や曖昧な場合に費用はかかりません。

クライアント設定

3行です。Claude Desktop（claude_desktop_config.json）または Cursor（.cursor/mcp.json）の場合：

{ "mcpServers": { "who": { "command": "npx", "args": ["-y", "@alienprobe/who-mcp"],
  "env": { "PRIVATE_KEY": "0x...", "MAX_USD_PER_SESSION": "1.00" } } } }

env ブロックを完全に削除してもサーバーは起動します。who_terms は利用できますが、who は wallet_not_configured を返して拒否します。まず試す場合は、この方法が安全です。

環境変数

変数	デフォルト	意味
PRIVATE_KEY	(なし)	少額の USDC を保有する、使い捨ての Base メインネットウォレットです。任意です。ログに記録されたり、出力されたり、ツールの結果として返されたりすることはありません。
MAX_USD_PER_CALL	0.10	1回の検索に対する上限です。検索の表示価格は $0.05 です。
MAX_USD_PER_SESSION	1.00	サーバープロセスが再起動までに使用する総額の上限です。

.env.example を参照してください。実際のキーは絶対にコミットしないでください。他の資産を保有していないウォレットに入金してください。USDC が約 $1 あれば、20回検索できます。このリポジトリでは Base への USDC の入金方法は説明していません。https://docs.base.org/base-chain/tools/bridges/ を参照してください。

支出上限

サーバーはすべての who 呼び出しについて、署名機能が存在しない経路で、ラップされていない通常の fetch を使って事前確認します。402 の価格表示を読み取ってから、処理を続けるかどうかを判断します。価格が MAX_USD_PER_CALL を超える場合、または実行中の合計額が MAX_USD_PER_SESSION を超える場合は、モデルが読み取って対応できる結果を返して拒否します。

{
  "error": "spend_cap_exceeded",
  "scope": "per_session",
  "price_usd": 0.05,
  "cap_usd": 1.0,
  "spent_usd_this_session": 1.0,
  "remaining_usd": 0.0,
  "hint": "the session budget is spent; raise MAX_USD_PER_SESSION and restart the MCP server to buy more"
}

セッションとは、1つのサーバープロセスのことです。クライアントを再起動するとカウンターがリセットされるため、セッションごとの上限は歯止めであり、台帳ではありません。実際の上限はウォレット残高です。少額に抑えてください。

返される内容

支払いが発生した検索では、API の本文がそのまま返され、paid_usd が追加されます。

{
  "schema_version": "who-lookup.v1",
  "subject": { "type": "who", "value": "apple.com" },
  "answer": {
    "lei": "HWUPKR0MPOU8FGXBT394",
    "legal_name": "Apple Inc.",
    "jurisdiction": "US-CA",
    "entity_status": "ACTIVE",
    "registration_status": "ISSUED",
    "match": { "by": "domain", "rule": "domain_exact" },
    "official_website": "https://apple.com/"
  },
  "source": { "name": "...", "vintage": "...", "coverage": "..." },
  "paid_usd": 0.05
}

q には、会社名、登録可能なドメイン、または20文字の LEI を指定します。会社名を曖昧さなく特定するには、同じ文字列の末尾に管轄区域を追加します（"Acme Corp;US-DE"）。

paid_usd は承認された価格であり、支払いの記録ではありません

paid_usd は、サーバーが承認した金額です。API が 402 で表示し、支出上限の判定に使われた価格です。ブロックチェーンから読み戻した金額ではありません。

実際より高く表示されるケースの1つとして、この価格帯でウォレットが初めて検索に成功した場合、決済額は $0 になります（初回無料。このサービスの仕様であり、このクライアントの仕様ではありません）。この呼び出しでも "paid_usd": 0.05 と報告されます。以降の呼び出しでは、実際に $0.05 が移動します。

サーバーのセッションカウンターにも同じ過大表示が反映されますが、これは安全側の動作です。遅れることなく、早めに停止します。正確な金額を知る必要がある場合は、ウォレットからのオンチェーンの USDC Transfer のみが支払いの記録となります。会計に paid_usd を使わないでください。

無料の拒否

これらの場合に支払いは発生せず、例外ではなく、モデルが推論できる通常のツール結果として返されます。

上流	結果
400	{"error":"invalid_subject","reason":"empty"}
404	{"error":"not_found","coverage":"..."}
409	{"error":"ambiguous","candidates":[...],"hint":"re-ask with the exact legal_name, then a ;jurisdiction suffix if it still collides"}
503	{"error":"source_unavailable"}

API は1つの法人を特定できる場合にのみ課金するため、曖昧な状態が続く限り、曖昧さを解消するための再問い合わせも無料です。

対応していないこと

• 住所、役員、取締役、所有関係のグラフはありません。
• 推測はしません。見つからない場合はベストエフォートの回答ではなく、404 を返します。
• ラテン文字または数字が2文字未満に正規化される法人名（CJK、キリル文字、ギリシャ文字、アラビア文字、ヘブライ文字、タイ文字）は、このデータの対象期間には一切含まれていません。名前での検索だけでなく、あらゆる検索に該当します。
• ドメインが一致するのは、ソースが LEI と公式ウェブサイトを結び付けている場合に限られ、登録可能なドメインが完全一致する必要があります。サブドメインは一致しません。

開発

npm install
npm test     # 28 contract rows over a mocked fetch: no network, no wallet, no payment
npm run smoke  # spawns the server, drives initialize/tools/list/who_terms over real stdio

npm run smoke はライブエンドポイントにアクセスして 402 を取得します。PRIVATE_KEY が空の状態で実行され、告知された amount が "50000"（$0.05）であることを検証します。支払いはできません。

src/core.mjs にはトランスポートに依存しないロジックが含まれており、注入された fetch を使用するため、テストでウォレットを用意する必要はありません。src/index.mjs は MCP の配線のみを担当します。@x402/* と viem は、支払いが許可された呼び出しでのみ遅延読み込みされます。

@modelcontextprotocol/sdk 1.30.0 を基盤として構築されています。契約の詳細と配布計画については、SPEC.md を参照してください。

ライセンス

MIT © Brent Bryson。LICENSE を参照してください。