# WebLens

> WebLens is a paid MCP server for web search and scraping. Pay-per-call web page extraction and Base token safety checks, settled in USDC. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Paid
- **Platforms:** CLI, API
- **Repository:** https://github.com/bartenderthiago82/x402-weblens-mcp
- **MCP Registry name:** io.github.bartenderthiago82/weblens
- **Categories:** [web search and scraping](https://ai-powered.com/categories/web-search-and-scraping), [finance and payments](https://ai-powered.com/categories/finance-and-payments)
- **Listing updated:** 2026-11-14

## About

WebLens charges per request in USDC on Base through the x402 payment protocol, with no account, API key or subscription. A separate wallet you fund with a few dollars signs each payment locally. A session spend cap defaults to $1 (`WEBLENS_MAX_SPEND_USD`), no single payment may exceed $0.05, and failed requests with status 400 or above are not charged. Setting the network to Base Sepolia allows testing.

Ten tools split into two groups. The web group returns page metadata, internal and external links, main content as clean Markdown, structured JSON that follows your schema, CSV converted to typed rows, and repair of broken LLM JSON. The RugProbe group evaluates Base tokens before trading: a simulated buy and sell for honeypot behaviour and real taxes, liquidity, owner powers and a 0 to 100 risk score, a fuller report with a clear, caution or avoid verdict, a position-size calculator and a gas advisor.

Prices range from $0.002 to $0.05 per call. Because it needs a private key, the README warns to use a dedicated wallet, never your main one.

## Features

- **Clean page extraction:** Main content as Markdown without ads, menus or popups.
- **Schema-driven structuring:** Turn a URL or text into JSON matching your JSON Schema.
- **Token safety check:** Simulated buy and sell, liquidity, owner powers and a risk score.
- **Spend limits:** Session cap and a $0.05 per-payment ceiling.
- **JSON repair:** Fix malformed LLM JSON and validate it against a schema.

## Good for

- Convert a web page into Markdown for an agent
- Pull links or metadata from a URL
- Check a Base token for honeypot behaviour before trading
- Turn CSV text into typed JSON rows
- Estimate stop-loss and position size

## Install

### Claude Code (Terminal)

```sh
claude mcp add weblens --env WEBLENS_WALLET_PRIVATE_KEY='<WEBLENS_WALLET_PRIVATE_KEY>' -- npx -y x402-weblens-mcp
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "weblens": {
      "command": "npx",
      "args": [
        "-y",
        "x402-weblens-mcp"
      ],
      "env": {
        "WEBLENS_WALLET_PRIVATE_KEY": "<WEBLENS_WALLET_PRIVATE_KEY>"
      }
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "weblens": {
      "command": "npx",
      "args": [
        "-y",
        "x402-weblens-mcp"
      ],
      "env": {
        "WEBLENS_WALLET_PRIVATE_KEY": "<WEBLENS_WALLET_PRIVATE_KEY>"
      }
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "weblens": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "x402-weblens-mcp"
      ],
      "env": {
        "WEBLENS_WALLET_PRIVATE_KEY": "<WEBLENS_WALLET_PRIVATE_KEY>"
      }
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "weblens": {
      "command": "npx",
      "args": [
        "-y",
        "x402-weblens-mcp"
      ],
      "env": {
        "WEBLENS_WALLET_PRIVATE_KEY": "<WEBLENS_WALLET_PRIVATE_KEY>"
      }
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "weblens": {
      "command": "npx",
      "args": [
        "-y",
        "x402-weblens-mcp"
      ],
      "env": {
        "WEBLENS_WALLET_PRIVATE_KEY": "<WEBLENS_WALLET_PRIVATE_KEY>"
      }
    }
  }
}
```

## Tools

- `weblens_metadata`: Return title, description, Open Graph, JSON-LD and favicon for a URL
- `weblens_links`: List internal and external links
- `weblens_extract`: Return main content as clean Markdown
- `weblens_structure`: Return JSON matching a supplied schema
- `rugprobe_check`: Check whether a Base token is safe to trade
- `rugprobe_report`: Full token report with website checks and a verdict
- `rugprobe_position_size`: Compute stop-loss and position size
- `rugprobe_gas`: Advise whether to submit now or wait on Base
- `weblens_csv_to_json`: Convert CSV into typed JSON rows
- `weblens_json_repair`: Repair and validate broken JSON

## FAQ

### Do I need an account?

No. Calls are paid in USDC on Base via x402.

### How is spending limited?

A per-session cap, default $1, and no single payment above $0.05.

### Am I charged for failed requests?

No, status 400 and above are not charged.

### Is my wallet key safe?

The README says it stays on your computer and only signs payments; it still advises a separate wallet.

### Is WebLens free?

No. WebLens is a paid product.

### How do I add WebLens to Claude Code?

Run this command in your terminal: claude mcp add weblens --env WEBLENS_WALLET_PRIVATE_KEY='<WEBLENS_WALLET_PRIVATE_KEY>' -- npx -y x402-weblens-mcp

### What are the best alternatives to WebLens?

The closest alternatives to WebLens are x402 Agent Tools, BaseLens, ZERO Payment Guard, Blackwood State and x402 Agent Utilities.

## Where this comes from

- Description: written from the project's README.
- Install steps: from the official MCP Registry entry.

## Alternatives

- [x402 Agent Tools](https://ai-powered.com/mcp/x402-agent-tools-2): x402 Agent Tools is a paid MCP server for web search and scraping.
- [BaseLens](https://ai-powered.com/mcp/baselens): BaseLens is a paid MCP server for finance and payments.
- [ZERO Payment Guard](https://ai-powered.com/mcp/zero-payment-guard): ZERO Payment Guard is a paid MCP server for finance and payments.
- [Blackwood State](https://ai-powered.com/mcp/blackwood-state): Blackwood State is a paid MCP server for web search and scraping.
- [x402 Agent Utilities](https://ai-powered.com/mcp/x402-agent-utilities): x402 Agent Utilities is a paid MCP server for finance and payments.
- [MCP Server](https://ai-powered.com/mcp/mcp-server-mwenkb1l): MCP Server is a paid MCP server for finance and payments.
- [Red Web Utils](https://ai-powered.com/mcp/red-web-utils): Red Web Utils is a paid MCP server for finance and payments.
- [Web Intel (x402)](https://ai-powered.com/mcp/web-intel-x402): Web Intel (x402) is a paid MCP server for web search and scraping.

---
Source: https://ai-powered.com/mcp/weblens-2
