Walletlens

io.github.shawnwollenberg由 GitHub 账号 shawnwollenberg 发布v0.1.2更新于 Oct 24, 2026

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

已验证STDIO仅桌面金融数据与分析

概览

AI 生成的概览

本地 MCP 服务器，为助手提供 WalletLens 免费服务元数据，以及通过 x402 以 USDC 付费的 EVM 钱包资产、交易与报告数据

可以做什么
获取 WalletLens 的免费服务元数据、支持的链和 OpenAPI 架构。查询付费的 EVM 钱包资产余额及美元估值。查询付费的规范化交易历史。生成付费的资产与交易合并报告，包含 Robinhood Stock Token 情报。
适用场景
当助手需要 EVM 钱包情报（如余额、交易历史或合并报告），且你愿意在 Base 主网上按次支付少量 USDC 时使用。免费元数据工具适合在充值钱包前先了解该服务。
运行要求
通过 npx 以 stdio 在本地运行，需要 Node.js 20 或更高版本。付费工具需要一个已充值 Base USDC 的专用 EVM 代理钱包，通过环境变量 WALLETLENS_X402_PRIVATE_KEY 提供。可选配置包括 WALLETLENS_MAX_PAYMENT_USDC、WALLETLENS_EXPECTED_PAY_TO、WALLETLENS_BASE_URL 和请求超时。需要能访问 WalletLens API 的网络。
安装前请注意
付费工具会在 Base 主网上花费真实 USDC，默认每次调用最多 0.02，每次调用最多尝试一次支付。服务器持有 WALLETLENS_X402_PRIVATE_KEY 中的私钥；请使用专用的低余额钱包，并避免将配置提交到源码库。支付在本地签名，但钱包查询和支付信息会发送至 WalletLens 服务。免费工具无需私钥。

安装

在 SourceWeft 中

  1. 打开 控制台中的 Walletlens，将其添加到工作区。
  2. 为需要使用其工具的对话启用该服务。

Desktop only，通过 STDIO。 STDIO 服务会启动本地进程，因此需要 SourceWeft 桌面宿主。

其他 MCP 客户端

参照 仓库 中的启动说明。

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

来源：packages/walletlens-mcp/README.md，提交 facde0b

工具

0
SourceWeft 尚未在沙箱中启动过该软件包，因此其工具未知。

版本历史

1
  1. v0.1.2最新Sep 16, 2026

评分

已满足适用检查项的 40%

该评分衡量此收录条目的完整程度，依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价，也不表示服务器安全或当前可用：可连通性是带日期的检查结果，评分也不包含安装量或用户评价。

  • 近 30 天内可连通25 分

    请保持端点能够响应 MCP 握手；SourceWeft 每 30 天探测一次。

  • 已声明认证方式10 分

    请在注册中心条目中声明凭据请求头，或保持端点能够响应探测，以便判定其认证方式。

  • 已列出工具15 分

    请让服务器在无凭据时响应 tools/list，或发布可在沙箱中无凭据启动的软件包。

  • 描述必需15 分
  • 图标10 分
  • 文档15 分
  • 许可证10 分

    请在仓库或注册中心条目中声明许可证。