Skip to main content
Glama
LensExtract x402 On-Chain MCP

LensExtract x402 On-Chain MCP

by alkeke45-cpu

LensExtract x402 On-Chain MCP

An open-source MCP (Model Context Protocol) server that connects MCP clients — Claude Desktop, Cursor, VS Code, Hermes Agent — to the LensExtract x402 API (https://lens-extract-x402.alkeke45.workers.dev): web-page extraction plus live on-chain / crypto-market data, paid per call in USDC on Base with the x402 protocol. No API keys, no subscriptions — each tool call settles its own micropayment.

Listed in the Official MCP Registry as io.github.alkeke45-cpu/lens-x402-onchain-mcp.

Tools

Tool

What it does

Price

lens_discover

Live x402 discovery document (endpoints, prices, payTo)

free

lens_extract

Clean markdown/text extraction from any public web page

$0.001

morpho_vault_audit

Morpho Vaults V2 census & timelock audit (68 vaults ≥ $5M, dual-RPC verified)

$0.10

crypto_alpha_feed

Live Morpho Vaults V2 TVL & APY feed

$0.05

base_gas_and_sequencer

Live Base gas, base fee, blob fee snapshot

$0.005

defi_yield_radar

Top 20 USDC yields on Base & Arbitrum (DeFiLlama, live)

$0.01

token_contract_guard

Heuristic ERC-20 contract screen (bytecode, proxy, views) — a screen, not a safety guarantee

$0.01

crypto_momentum_signals

BTC/ETH/SOL momentum stats (price, 7d change, RSI-14) — descriptive, not advice

$0.01

stablecoin_peg_monitor

USD stablecoin peg deviations in bps (live)

$0.005

fear_greed

Fear & Greed index + 30d history (live)

$0.005

base_wallet_scan

Base address balances (ETH, USDC, WETH, DAI), tx count, contract flag

$0.01

ens_lookup

ENS forward/reverse resolution

$0.005

ask_kinetic_dune

Ask the Kinetic Dune tutor — paid on the Stacks rail (10 sats sBTC); this EVM client returns the live 402 requirements for a Stacks-capable client

10 sats

All Base prices are USDC on Base (chain 8453), paid to the API operator 0x8488E45d428a3B2BC7116c8657b8FF23Cd042ef6.

Related MCP server: AgentScout MCP Server

How payment works

The API answers unpaid calls with HTTP 402 and an x402 v2 PAYMENT-REQUIRED challenge. This server wraps fetch with the official @x402/fetch client and the @x402/evm exact scheme: it signs an EIP-3009 USDC transferWithAuthorization with your wallet key and retries with a PAYMENT-SIGNATURE header. The API's facilitator settles on Base. Your key is used locally only — it is never sent anywhere.

You need a Base wallet holding a small amount of USDC (a dollar covers hundreds of calls). Without a key, the free discovery tool still works and paid tools return the API's payment requirements instead of data.

Install

MCPB bundle (Claude Desktop)

Download lens-x402-onchain-mcp.mcpb from the latest GitHub release and open it with Claude Desktop (or double-click it). You will be asked for your Base wallet private key once; it is stored by the host as a secret.

From source (any MCP client)

git clone https://github.com/alkeke45-cpu/lens-x402-onchain-mcp.git
cd lens-x402-onchain-mcp
npm install

Claude Desktop / Cursor / VS Code MCP config:

{
  "mcpServers": {
    "lens-x402": {
      "command": "node",
      "args": ["/absolute/path/to/lens-x402-onchain-mcp/src/index.js"],
      "env": {
        "LENS_X402_PRIVATE_KEY": "0xYOUR_BASE_WALLET_PRIVATE_KEY"
      }
    }
  }
}

Docker

docker build -t lens-x402-onchain-mcp .
docker run -i --rm -e LENS_X402_PRIVATE_KEY=0xYOUR_KEY lens-x402-onchain-mcp

Configuration

Variable

Required

Meaning

LENS_X402_PRIVATE_KEY

for paid tools

Your own Base wallet private key holding USDC. Never share it; it stays on your machine.

LENS_X402_BASE_URL

no

Override the API base URL (default https://lens-extract-x402.alkeke45.workers.dev).

Smoke test

npm run smoke         # handshake + tools/list + live free discovery call
npm run smoke:offline # handshake + tools/list only

Publishing (maintainers)

server.json is published to the Official MCP Registry by .github/workflows/publish-mcp.yml on every push to main: it builds the MCPB bundle, uploads it to the v0.1.0 GitHub release, writes its SHA-256 into server.json, then publishes with mcp-publisher using GitHub OIDC (no stored credentials). Bump the version in package.json, server.json, manifest.json and the workflow's RELEASE_TAG together for a new release.

License

MIT — see LICENSE.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      B
      quality
      D
      maintenance
      Exposes 25 paid API endpoints as MCP tools for AI agents, with payments in USDC on Base mainnet via the x402 protocol, enabling tasks like web search, company intelligence, and crypto research.
      25
      121 npm
      MIT
    • A
      license
      Not graded
      quality
      D
      maintenance
      Pay-per-call MCP server for WebberSites x402 Data API, offering 45 tools for AI agents: web scraping, document extraction, SEO audits, linting, crypto data, and more, with payment via USDC on Base.
      69 npm
      MIT
    • A
      license
      A
      quality
      C
      maintenance
      Enables MCP-capable AI agents to make pay-per-call Solana data requests (snapshots, risk checks, token reports, health, balances, transactions, trending pairs) with automatic USDC settlement over x402.
      5
      MIT