mcpField
W
walletlens

walletlens

Local
github.com/shawnwollenbergFinance0Updated 13w ago
Repository

About walletlens

WalletLens MCP provides MCP-compatible agents with EVM wallet reports and Robinhood Stock Token intelligence. Free discovery tools accompany paid portfolio and transaction reports, with x402 payments signed locally using a dedicated wallet.

Key features

  1. 01Retrieve portfolio balances and USD values
  2. 02Read normalized transaction history
  3. 03Combine portfolio and transaction data in reports
  4. 04Inspect service, chain, and OpenAPI metadata
  5. 05Sign x402 payments locally with policy checks

Use cases

  1. 01Review an EVM wallet portfolio
  2. 02Inspect wallet transaction history
  3. 03Request a combined wallet report
  4. 04Check service pricing and supported chains

MCP support

Runs as a local MCP server over stdio and exposes free metadata tools plus paid wallet intelligence tools. Paid requests use locally signed x402 payments; the private key is not sent to WalletLens.

Configuration

Local server config is the same for every client. Copy it into your client’s MCP config file.

mcp.json · Universal config
{
  "mcpServers": {
    "shawnwollenberg-walletlens": {
      "command": "npx",
      "args": [
        "-y",
        "@shawnwollenberg/walletlens-mcp"
      ],
      "env": {
        "WALLETLENS_X402_PRIVATE_KEY": "<WALLETLENS_X402_PRIVATE_KEY>",
        "WALLETLENS_MAX_PAYMENT_USDC": "<WALLETLENS_MAX_PAYMENT_USDC>",
        "WALLETLENS_EXPECTED_PAY_TO": "<WALLETLENS_EXPECTED_PAY_TO>",
        "WALLETLENS_BASE_URL": "<WALLETLENS_BASE_URL>"
      }
    }
  }
}
Run commandnpx -y @shawnwollenberg/walletlens-mcp
Environment variables to set
WALLETLENS_X402_PRIVATE_KEYSecretDedicated agent-wallet private key for paid x402 tools.
WALLETLENS_MAX_PAYMENT_USDCMaximum USDC allowed for one report. Defaults to 0.02.
WALLETLENS_EXPECTED_PAY_TOExpected WalletLens payment recipient address.
WALLETLENS_BASE_URLWalletLens API origin. Defaults to the production service.

Local servers need a runtime on your machine (e.g. Node.js 18+). Config file locations differ by client; see your client’s docs.

Packages
npm@shawnwollenberg/walletlens-mcp0.1.2

Tools

6

Saved tool list · updated 3w ago

This tool takes no parameters.

Details

From the project README

WalletLens MCP

WalletLens MCP gives MCP-compatible agents access to free service discovery and paid EVM wallet intelligence, including Robinhood Stock Token reports, through x402.

The server runs locally over stdio. Paid requests are signed locally with a dedicated agent wallet; WalletLens never receives the private key.

Available tools

  • get_service_metadata — free live pricing, documentation, and service metadata
  • get_supported_chains — free supported-chain metadata
  • get_openapi_schema — free OpenAPI schema
  • get_portfolio — paid portfolio balances and USD values
  • get_tx_history — paid normalized transaction history
  • get_wallet_report — paid combined portfolio and transaction report

Paid tools cost up to 0.02 USDC per invocation on Base mainnet. Each invocation performs at most one payment attempt.

Requirements

  • Node.js 20 or newer
  • A dedicated EVM agent wallet funded with Base USDC
  • An MCP-compatible client

MCP configuration

Add the following to your MCP client configuration. Replace the private key with a dedicated, low-balance agent wallet and keep the configuration out of source control.

{
  "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"
      }
    }
  }
}

Free tools work without a private key. Paid tools return a missing_private_key result until WALLETLENS_X402_PRIVATE_KEY is configured.

Payment safety policy

Before signing, the MCP server requires all of the following:

  • exact payment scheme
  • Base mainnet (eip155:8453)
  • Base USDC (0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913)
  • Amount at or below WALLETLENS_MAX_PAYMENT_USDC, defaulting to 0.02 USDC
  • WalletLens origin and the requested WalletLens resource path
  • The configured recipient, defaulting to 0xA7c82E9775A9594c673E3Fde8a42D3D17dE2B957

If a challenge violates the policy, the server refuses to sign it.

Environment variables

VariableRequiredDefaultPurpose
WALLETLENS_X402_PRIVATE_KEYPaid tools only—Dedicated local signing key
WALLETLENS_MAX_PAYMENT_USDCNo0.02Maximum payment per tool call
WALLETLENS_EXPECTED_PAY_TONoWalletLens recipientRequired payment recipient
WALLETLENS_BASE_URLNohttps://walletlens.wallyweb.comWalletLens API origin
WALLETLENS_REQUEST_TIMEOUT_MSNo20000Request timeout in milliseconds

Run directly

npx --yes @shawnwollenberg/[email protected]

The process communicates over MCP stdio and normally prints no human-readable output. Use --help or --version for CLI information.

Links

Comments

Markdown supported

New to MCP?

From what the protocol is to installing your first server, these answers cover most first questions.

An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.