walletlens

WalletLens MCP

WalletLens MCP を使用すると、MCP 互換エージェントは、x402 を通じて、無料のサービス検出機能と、有料の EVM ウォレット分析機能（Robinhood Stock Token レポートを含む）を利用できます。

サーバーは stdio 経由でローカル実行されます。有料リクエストには専用のエージェントウォレットでローカル署名し、WalletLens が秘密鍵を受け取ることはありません。

利用可能なツール

• get_service_metadata — 価格、ドキュメント、サービスメタデータをリアルタイムで無料取得
• get_supported_chains — 対応チェーンのメタデータを無料取得
• get_openapi_schema — OpenAPI スキーマを無料取得
• get_portfolio — ポートフォリオの残高と USD 換算額を有料で取得
• get_tx_history — 正規化された取引履歴を有料で取得
• get_wallet_report — ポートフォリオと取引の統合レポートを有料で取得

有料ツールの料金は、Base メインネットでの呼び出し 1 回あたり最大 0.02 USDC です。呼び出しごとの支払い試行は最大 1 回です。

必要条件

• Node.js 20 以降
• Base USDC を入金した専用の EVM エージェントウォレット
• MCP 互換クライアント

MCP の設定

以下を MCP クライアントの設定に追加します。秘密鍵を専用の少額残高のエージェントウォレットのものに置き換え、設定をソース管理の対象外にしてください。

{
  "mcpServers": {
    "walletlens": {
      "command": "npx",
      "args": ["--yes", "@shawnwollenberg/[email protected]"],
      "env": {
        "WALLETLENS_X402_PRIVATE_KEY": "0xYOUR_DEDICATED_AGENT_PRIVATE_KEY",
        "WALLETLENS_MAX_PAYMENT_USDC": "0.02",
        "WALLETLENS_EXPECTED_PAY_TO": "0xA7c82E9775A9594c673E3Fde8a42D3D17dE2B957"
      }
    }
  }
}

無料ツールは秘密鍵なしで使用できます。WALLETLENS_X402_PRIVATE_KEY が設定されるまで、有料ツールは missing_private_key の結果を返します。

支払いの安全ポリシー

署名する前に、MCP サーバーは以下のすべてを必須とします。

• exact 支払いスキーム
• Base メインネット（eip155:8453）
• Base USDC（0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913）
• WALLETLENS_MAX_PAYMENT_USDC 以下の金額（デフォルトは 0.02 USDC）
• WalletLens のオリジンと、リクエストされた WalletLens のリソースパス
• 設定された受取先（デフォルトは 0xA7c82E9775A9594c673E3Fde8a42D3D17dE2B957）

チャレンジがポリシーに違反する場合、サーバーは署名を拒否します。

環境変数

変数	必須	デフォルト	用途
WALLETLENS_X402_PRIVATE_KEY	有料ツールのみ	—	ローカルで署名する専用キー
WALLETLENS_MAX_PAYMENT_USDC	いいえ	0.02	ツール呼び出しごとの最大支払額
WALLETLENS_EXPECTED_PAY_TO	いいえ	WalletLens の受取先	必須の支払先
WALLETLENS_BASE_URL	いいえ	https://walletlens.wallyweb.com	WalletLens API のオリジン
WALLETLENS_REQUEST_TIMEOUT_MS	いいえ	20000	リクエストのタイムアウト（ミリ秒）

直接実行

npx --yes @shawnwollenberg/[email protected]

プロセスは MCP stdio 経由で通信し、通常は人間向けの出力を表示しません。CLI 情報を確認するには、--help または --version を使用してください。

リンク

• WalletLens
• OpenAPI
• エージェント向けドキュメント
• 公式 MCP レジストリ
• ソースリポジトリ