walletbureau

@walletbureau/mcp

支払いの前に、相手が誰なのかを確認しましょう。 エージェントに1つのツールを提供する MCP サーバーです。送金する前に、Base 上のウォレットの行動リスクをスコアリングします。

スコアは、Base 上の x402 / EIP-3009 USDC 決済の全履歴に基づいています。アドレスの使用期間、誰が支払っているか、流入がどれほど集中しているか、アクティビティが急増したばかりかどうかを調べます。0〜100 の数値、判定（ok / caution / avoid）、およびそれらの根拠となったリスクフラグが、それぞれ平易な言葉で理由とともに表示されます。

これらはリスクのシグナルであり、非難を意味するものではありません。方法論については、https://walletbureau.com/methodology をご覧ください。

インストール

npm i @walletbureau/mcp --ignore-scripts

このパッケージには、すぐに実行できる JavaScript が含まれています。インストールスクリプト、ネイティブモジュール、マシン上でのビルド手順はありません。--ignore-scripts を指定しても何も変わりません。意図した設計です。

Claude Code

claude mcp add walletbureau -- npx -y @walletbureau/mcp

Claude Desktop ／ Cursor ／任意の MCP クライアント

MCP 設定に以下を追加してください（Claude Desktop の場合は claude_desktop_config.json）。

{
  "mcpServers": {
    "walletbureau": {
      "command": "npx",
      "args": ["-y", "@walletbureau/mcp"]
    }
  }
}

設定はこれで完了です。認証情報がない場合、サーバーは公開の無料利用枠（1日あたり数回のチェック）で動作するため、試用には十分です。引き続き利用するには、以下から支払い方法を選んでください。

チェックの支払い

1回のチェックの料金は $0.01 です。サーバーは環境変数に基づいて支払い方法を選びます。

モード	設定するもの	動作
無料デモ	なし	公開デモの利用枠（IPアドレスごとに1日数回のチェック）を使います。
プリペイドキー	WALLETBUREAU_API_KEY=atk_…	各チェックの料金がキー残高から差し引かれます。暗号資産は使いません。
ウォレット（x402）	X402_PRIVATE_KEY=0x…	x402 を通じて、サーバーがチェックごとにBase上で$0.01相当のUSDCを自動的に支払います。

両方が設定されている場合は、プリペイドキーが優先されます。キーの残高はすでに支払い済みであり、オンチェーン決済を行うと二重請求になるためです。

{
  "mcpServers": {
    "walletbureau": {
      "command": "npx",
      "args": ["-y", "@walletbureau/mcp"],
      "env": { "WALLETBUREAU_API_KEY": "atk_your_key_here" }
    }
  }
}

ウォレットから支払う場合

X402_PRIVATE_KEY は実際に資金を使うための秘密鍵です。慎重に取り扱ってください。

• 少額のUSDCを入金した専用ウォレットを使用してください。メインアカウントは使わないでください。
• キーがマシンの外に出ることはありません。x402 決済の署名に使用されますが、ログに記録されたり、サービスに送信されたり、ツールの出力に含まれたりすることはありません。サービスに渡るのは決済情報のみです。
• X402_MAX_PRICE_USD（デフォルトは 0.10）で、1回の呼び出しにかかる料金の上限を設定できます。料金はリモートサーバーが提示するため、このチェックはプロンプト内ではなく、署名処理の隣にあるコードで行われます。

ツール

check_counterparty — 有料

入力：{ "address": "0x…" } — Base 上のウォレットアドレス。

スコア、判定、理由付きのリスクフラグ、およびその根拠となる集計統計を含むレポート全体を返します。料金は呼び出し前にクライアントから確認できます。ツールの説明と、ツールの _meta 内の walletbureau/pricing の両方に表示されます。

{
  "address": "0x…",
  "score": 74,
  "verdict": "ok",
  "flags": [
    { "code": "activity_spike", "severity": "low",
      "reason": "Volume over the last 24 h is 12× the median of the last 30 days" }
  ],
  "stats": {
    "first_seen": "2025-11-02T…Z", "tx_in": 1204, "tx_out": 17,
    "volume_in_usd": "604.31", "volume_out_usd": "12.05",
    "distinct_payers": 311, "confidence_basis": "confirmed+probable"
  },
  "meta": { "computed_at": "…", "cache_age_seconds": 312, "api_version": "v1", "disclaimer": "…" }
}

レスポンススキーマは安定した契約です。フィールドの追加のみが行われ、名称変更や削除が必要な場合は新しい API バージョンになります。API とともに JSON Schema として公開されています。

get_service_stats — 無料

入力はありません。インデックスの公開カウンター（インデックス済みアドレス数、取り込み済み送金数、提供済みスコア数）を返します。

設定

変数	デフォルト	意味
API_BASE_URL	https://walletbureau.com	サービスの稼働先です。独自のデプロイ先を指定する場合にのみ変更してください。
WALLETBUREAU_API_KEY	—	プリペイド API キー。atk_…。
X402_PRIVATE_KEY	—	x402 を通じて呼び出しごとの料金を支払う秘密鍵。
X402_MAX_PRICE_USD	0.10	有料呼び出し1回あたりの料金の上限。
REQUEST_TIMEOUT_MS	5000	サービスへの未払いリクエストのタイムアウト。
PAYMENT_TIMEOUT_MS	60000	署名とオンチェーン決済を含む、有料呼び出しのタイムアウト。

サーバーは stderr にのみログを出力します。stdout は MCP プロトコル専用です。

このサーバーが行わないこと

スコアリングロジックも独自のデータもありません。公開 HTTP API を薄くラップしているため、方法論の修正はパッケージのアップグレードなしで反映されます。ローカルキャッシュもありません。サービス側でキャッシュしているため、キャッシュをもう1つ持つと、サービスとの間に差異が生じるだけです。

ライセンス

Apache-2.0