WalletLens

WalletLens is a pay per query blockchain intelligence platform that lets both humans and AI agents analyze any wallet enabling nanopayments. It exposes a simple web UI, REST API, and MCP server so users, scripts, and tools like Claude or Cursor can all request onchain intelligence the same way. Each call, wallet analysis, transfer history, or a full report is paid in USDC using the x402 protocol, so access is permissionless and metered per request rather than via subscriptions or API keys. Behind the scenes WalletLens enriches raw on‑chain activity with labels, entities, and risk signals from Arkham, then turns that into readable summaries and markdown reports so users can quickly understand who a wallet belongs to and how it behaves.

WalletLens is built as a TypeScript monorepo with three apps: an Express + Prisma API on PostgreSQL and Redis, a Next.js 16 React frontend, and a publishable MCP server package for AI integrations. The backend handles SIWE wallet login, talks to Arkham’s intelligence and transfers APIs in parallel, runs Claude to summarize results, and stores both structured JSON and rendered markdown reports in Postgres, with Redis caching to avoid hitting Arkham rate limits. Payments are handled through MonkePay’s x402‑fetch client: each request atomically charges USDC on Base/Base‑Sepolia and records the paying agent address and transaction hash alongside the report. On the frontend, RainbowKit/Wagmi provide wallet connection, while a responsive dark‑mode UI lets users trigger analysis, inspect transfers, and browse their report history. The MCP server wraps the same endpoints as three tools i.e, analyze_wallet, get_transfers, and generate_report so Claude Desktop can spin up an on demand wallet analyst agent with a single npx @walletlens/mcp setup command