Walletlens

io.github.shawnwollenbergPublished by GitHub account shawnwollenbergv0.1.2Updated Oct 24, 2026

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

VerifiedSTDIODesktop onlyFinanceData & Analytics

Overview

AI-generated overview

A local MCP server that gives assistants free WalletLens service metadata plus paid EVM wallet portfolio, transaction and report data, settled in USDC over x402

What you can do
Retrieve free service metadata, supported chains and the OpenAPI schema from WalletLens. Fetch paid portfolio balances with USD values for an EVM wallet. Fetch paid normalized transaction history. Generate a paid combined portfolio and transaction report, including Robinhood Stock Token intelligence.
When to use it
Use it when an assistant needs EVM wallet intelligence such as balances, transaction history or combined reports, and you are willing to pay small per-call USDC fees on Base mainnet. The free metadata tools are useful for inspecting the service before funding a wallet.
Requirements
Runs locally over stdio via npx, so Node.js 20 or newer is needed. Paid tools require a dedicated EVM agent wallet funded with Base USDC, supplied through the WALLETLENS_X402_PRIVATE_KEY environment variable. Optional settings include WALLETLENS_MAX_PAYMENT_USDC, WALLETLENS_EXPECTED_PAY_TO, WALLETLENS_BASE_URL and a request timeout. Network access to the WalletLens API is required.
Before you install
Paid tools spend real USDC on Base mainnet, up to 0.02 per call by default, with at most one payment attempt per invocation. The server holds a private key in WALLETLENS_X402_PRIVATE_KEY; use a dedicated, low-balance wallet and keep the configuration out of source control. Payments are signed locally, but wallet queries and payment details go to the WalletLens service. Free tools work without a key.

Installation

In SourceWeft

  1. Open Walletlens in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

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.

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

bash
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

Source: packages/walletlens-mcp/README.md at commit facde0b

Tools

0
SourceWeft has not started this package in its sandbox yet, so its tools are not known.

Version history

1
  1. v0.1.2LatestSep 16, 2026

Score

40% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 days25 pts

    Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.

  • Auth declared10 pts

    Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.

  • Tools listed15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts

    Declare a license in the repository or the registry entry.