Walletlens MCP Server

by shawnwollenbergio.github.shawnwollenberg/walletlensv0.1.2

EVM wallet reports and Robinhood Stock Token intelligence paid with USDC over x402.

0Node.jsstdioofficial registry

context tax

queued

security

queued

cold start

queued

freshness

Maintained2mo ago

Install Walletlens MCP server

claude mcp add walletlens -e WALLETLENS_X402_PRIVATE_KEY='<walletlens-x402-private-key>' -- npx -y @shawnwollenberg/walletlens-mcp

{
  "mcpServers": {
    "walletlens": {
      "command": "npx",
      "args": [
        "-y",
        "@shawnwollenberg/walletlens-mcp"
      ],
      "env": {
        "WALLETLENS_X402_PRIVATE_KEY": "<walletlens-x402-private-key>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json (global) or .cursor/mcp.json (project).

{
  "mcpServers": {
    "walletlens": {
      "command": "npx",
      "args": [
        "-y",
        "@shawnwollenberg/walletlens-mcp"
      ],
      "env": {
        "WALLETLENS_X402_PRIVATE_KEY": "<walletlens-x402-private-key>"
      }
    }
  }
}

Settings → Developer → Edit Config (claude_desktop_config.json), then restart.

{
  "servers": {
    "walletlens": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@shawnwollenberg/walletlens-mcp"
      ],
      "env": {
        "WALLETLENS_X402_PRIVATE_KEY": "<walletlens-x402-private-key>"
      }
    }
  }
}

Add to .vscode/mcp.json in your workspace.

{
  "mcpServers": {
    "walletlens": {
      "command": "npx",
      "args": [
        "-y",
        "@shawnwollenberg/walletlens-mcp"
      ],
      "env": {
        "WALLETLENS_X402_PRIVATE_KEY": "<walletlens-x402-private-key>"
      }
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json.

Configuration

Variable	Required	Secret	Description
WALLETLENS_X402_PRIVATE_KEY	—	yes	Dedicated agent-wallet private key for paid x402 tools.
WALLETLENS_MAX_PAYMENT_USDC	—	—	Maximum USDC allowed for one report. Defaults to 0.02.
WALLETLENS_EXPECTED_PAY_TO	—	—	Expected WalletLens payment recipient address.
WALLETLENS_BASE_URL	—	—	WalletLens API origin. Defaults to the production service.

Freshness

Maintained — last maintenance signal 2mo ago. The newest of the signals below sets the band.

Last commit (default branch)
2026-08-03 · 2mo ago · GitHub
Latest release
no data · GitHub
Package published
no data · npm/PyPI
Registry entry updated
2026-08-03 · 2mo ago · official registry · v0.1.2

FAQ

›How do I install the Walletlens MCP server in Claude Code?

Run: claude mcp add walletlens -e WALLETLENS_X402_PRIVATE_KEY='<walletlens-x402-private-key>' -- npx -y @shawnwollenberg/walletlens-mcp. For Cursor, VS Code, Claude Desktop and Windsurf, use the install tabs above.

›Does Walletlens require an API key?

Yes. It expects WALLETLENS_X402_PRIVATE_KEY, of which 1 is a secret.

›Can I use Walletlens as a remote (hosted) MCP server?

No hosted endpoint is published; it runs locally over stdio.

›Is Walletlens in the official MCP registry?

Yes, as io.github.shawnwollenberg/walletlens.