Extract clean web content as Markdown or JSON and perform RugProbe security checks on Base tokens using USDC payments.
Also known as bartenderthiago82/x402-weblens-mcp, x402-weblens-mcp
- Stars
- 0
- Tools
- —
- Downloads, 30 days
- —
- Latest version
- 1.4.0
- Last commit
- Nov 12, 2026
- License
- MIT
What is WebLens MCP?
WebLens extracts clean web content as Markdown or JSON and perform RugProbe security checks on Base tokens using USDC payments.
Summary generated from the project's README
About WebLens MCP server
Extracting clean web content and auditing Base network tokens from inside an AI client is what WebLens enables. Developers using Claude or Cursor can access tools to pull metadata, extract main content as Markdown, or convert web pages into structured JSON following a specific schema. It also includes specialized security tools for analyzing cryptocurrency tokens on the Base network.
Users connect by adding the server to their MCP configuration using a private key for a dedicated wallet containing USDC. There are no subscriptions or API keys required because every tool call is paid for individually via x402 on the Base network. You can set a maximum spending limit in USD to control costs during a session.
The toolkit includes RugProbe for checking token safety through simulated buys and sells, as well as gas advice and position sizing. It also provides utility functions like repairing broken JSON or converting CSV files into typed JSON rows.
Written from the project's README. Every use case is checked against a quote from it.
How to install WebLens MCP
Formats verified 10 Nov 2026Add to CursorAdd to GooseInstall WebLens MCP in Claude Code
$ claude mcp add --env 'WEBLENS_WALLET_PRIVATE_KEY=<YOUR_WEBLENS_WALLET_PRIVATE_KEY>' weblens -- npx -y x402-weblens-mcpInstall WebLens MCP in Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"weblens": {
"command": "npx",
"args": [
"-y",
"x402-weblens-mcp"
],
"env": {
"WEBLENS_WALLET_PRIVATE_KEY": "<YOUR_WEBLENS_WALLET_PRIVATE_KEY>"
}
}
}
}Install WebLens MCP in VS Code
.vscode/mcp.json
{
"servers": {
"weblens": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"x402-weblens-mcp"
],
"env": {
"WEBLENS_WALLET_PRIVATE_KEY": "<YOUR_WEBLENS_WALLET_PRIVATE_KEY>"
}
}
}
}Install WebLens MCP in VS Code CLI
$ code --add-mcp '{"name":"weblens","type":"stdio","command":"npx","args":["-y","x402-weblens-mcp"],"env":{"WEBLENS_WALLET_PRIVATE_KEY":"<YOUR_WEBLENS_WALLET_PRIVATE_KEY>"}}'Install WebLens MCP in Claude Desktop
claude_desktop_config.json
{
"mcpServers": {
"weblens": {
"command": "npx",
"args": [
"-y",
"x402-weblens-mcp"
],
"env": {
"WEBLENS_WALLET_PRIVATE_KEY": "<YOUR_WEBLENS_WALLET_PRIVATE_KEY>"
}
}
}
}Install WebLens MCP in Codex
$ codex mcp add weblens --env 'WEBLENS_WALLET_PRIVATE_KEY=<YOUR_WEBLENS_WALLET_PRIVATE_KEY>' -- npx -y x402-weblens-mcpInstall WebLens MCP in Codex config.toml
~/.codex/config.toml
[mcp_servers.weblens] command = "npx" args = ["-y", "x402-weblens-mcp"] [mcp_servers.weblens.env] WEBLENS_WALLET_PRIVATE_KEY = "<YOUR_WEBLENS_WALLET_PRIVATE_KEY>"
Install WebLens MCP in Gemini CLI
$ gemini mcp add -s user -e 'WEBLENS_WALLET_PRIVATE_KEY=<YOUR_WEBLENS_WALLET_PRIVATE_KEY>' weblens npx -- -y x402-weblens-mcpInstall WebLens MCP in Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"weblens": {
"command": "npx",
"args": [
"-y",
"x402-weblens-mcp"
],
"env": {
"WEBLENS_WALLET_PRIVATE_KEY": "<YOUR_WEBLENS_WALLET_PRIVATE_KEY>"
}
}
}
}Configuration
WEBLENS_WALLET_PRIVATE_KEYRequiredSecretPrivate key of a separate wallet holding a few dollars of USDC on Base; signs each payment locally
WEBLENS_MAX_SPEND_USDMost the server may spend per session, in USD (default 1)
| Name | Description | |
|---|---|---|
| WEBLENS_WALLET_PRIVATE_KEY | Private key of a separate wallet holding a few dollars of USDC on Base; signs each payment locally | RequiredSecret |
| WEBLENS_MAX_SPEND_USD | Most the server may spend per session, in USD (default 1) |
Automated checks
Ran Nov 14, 2026Full report →Passed our automated checks. That is not a security audit: read the code and give the server the narrowest access it needs. How checks work
- Source repository linked and reachablebartenderthiago82/x402-weblens-mcp is public and reachablegithub.com/bartenderthiago82/x402-weblens-mcp ↗Pass
- Package names this repository as its sourcex402-weblens-mcp names bartenderthiago82/x402-weblens-mcp as sourcenpmjs.com/package/x402-weblens-mcp ↗Pass
- Build provenance (Sigstore attestation)No build attestation published for this releaseNot checked
- Open source license (OSI)MITspdx.org/licenses/MIT.html ↗Pass
- Commit or release in the last yearLast commit or release 2026-11-12github.com/bartenderthiago82/x402-weblens-mcp ↗Pass
- OpenSSF ScorecardNot checked
- Package name not close to a popular packageNo popular package one edit away from x402-weblens-mcpPass
- No critical advisory in the package or its dependenciesthe package checked; no critical advisoryosv.dev ↗Pass
- No hidden instructions to the model0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersPass
- Destructive tools are labelledNot checked
- Remote endpoint answers the MCP handshakeNot checked
README
View on GitHubWebLens MCP
Give Claude, Cursor or any MCP client four tools for reading the web, plus RugProbe to check a Base token before trading. Each call is paid in USDC on Base via x402. There is no account, no API key and no subscription.
| Tool | What it returns | Price |
|---|---|---|
weblens_metadata |
Title, description, Open Graph, JSON-LD, favicon | $0.002 |
weblens_links |
All links, split into internal and external | $0.002 |
weblens_extract |
Main content as clean Markdown (no ads, menus or popups) | $0.005 |
weblens_structure |
JSON that follows your JSON Schema, from a URL or text | $0.02 |
rugprobe_check |
RugProbe: is this Base token safe to trade? Simulated buy/sell (honeypot, real taxes), liquidity, owner powers, 0-100 risk score | $0.01 |
rugprobe_report |
RugProbe Report: everything above plus the project website (does it list this contract? domain age, socials), a clear/caution/avoid verdict and a short summary | $0.05 |
rugprobe_position_size |
Stop-loss and position size from account risk % and ATR | $0.002 |
rugprobe_gas |
Base gas advisor: submit now or wait, fee suggestions, USD cost | $0.002 |
weblens_csv_to_json |
CSV to typed JSON rows (snake_case keys, column types) | $0.002 |
weblens_json_repair |
Fix broken LLM JSON and validate it against a schema | $0.002 |
Setup
- Create a separate wallet for this and put a few dollars of USDC on Base in it. Never use your main wallet.
- Add the server to your MCP client. For Claude Desktop, put this in
claude_desktop_config.json:
{
"mcpServers": {
"weblens": {
"command": "npx",
"args": ["-y", "x402-weblens-mcp"],
"env": {
"WEBLENS_WALLET_PRIVATE_KEY": "0x...",
"WEBLENS_MAX_SPEND_USD": "1"
}
}
}
}
For Claude Code: claude mcp add weblens -e WEBLENS_WALLET_PRIVATE_KEY=0x... -- npx -y x402-weblens-mcp
Settings
| Variable | Default | Meaning |
|---|---|---|
WEBLENS_WALLET_PRIVATE_KEY |
required | Key of the wallet that pays. It stays on your computer and is only used to sign each payment. |
WEBLENS_MAX_SPEND_USD |
1 |
The most the server may spend in one session; further payments are refused. |
WEBLENS_NETWORK |
eip155:8453 |
Base mainnet. Use eip155:84532 for Base Sepolia testnet. |
WEBLENS_API_URL |
WebLens production | API address. |
Safety: no single payment may exceed $0.05. Failed requests (status 400 or above) are not charged.
HTTP API and docs: https://x402-weblens-api-production.up.railway.app
WebLens MCP questions
How do I add WebLens MCP to Claude Code?
Run claude mcp add --env 'WEBLENS_WALLET_PRIVATE_KEY=<YOUR_WEBLENS_WALLET_PRIVATE_KEY>' weblens -- npx -y x402-weblens-mcp in your terminal. Add --scope user to make it available in every project.
How do I add WebLens MCP to Cursor?
Open ~/.cursor/mcp.json and add the server under mcpServers, using the Cursor config shown in the install section above.
What does RugProbe do?
RugProbe checks if a Base token is safe to trade by simulating buys/sells, checking liquidity, owner powers, and providing a risk score.
Am I charged if a request fails?
No, requests that result in a status code of 400 or higher are not charged.