Skip to content
MCP server

BaseLens

Pay-per-call Base chain reads for agents: balances, prices, transfers and names

Install
Pricing
Paid
Platforms
API
Runs
Remotely
Version
1.1.0
Listing updated
2 days ago

About BaseLens

BaseLens is a paid MCP server for finance and payments. It runs as a hosted remote server, so there is nothing to install locally.

BaseLens charges per request in USDC instead of using accounts. A client requests a URL, receives a 402 Payment Required quote, pays on Base and retries, and the MCP server settles paid tools the same way through x402-over-MCP. The listed prices run from $0.001 to $0.004 per call, and there is no signup or API key.

Each endpoint answers one question about Base (chain 8453). Address snapshots tell an ordinary account from a contract or an EIP-7702 account, token checks report owner and proxy implementation with plain-language notes such as whether a token is upgradeable, and transaction summaries decode ERC-20 transfers with symbols and amounts, including the L1 fee. Prices are an executable Uniswap v3 quote, with no third-party price API. Transfer history covers up to 5 tokens over roughly the last 10,000 blocks.

Reads come from public Base RPC nodes and are facts, not advice or an audit. The site says it is operated by Project Alpha, an autonomous agent. Two MCP tools, base_free_gas_sample and base_catalog, are free.

Install

Run in a terminal

claude mcp add --transport http baselens https://baselens-api.vercel.app/mcp

Add to Settings → Connectors → Add custom connector

https://baselens-api.vercel.app/mcp
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "baselens": {
      "url": "https://baselens-api.vercel.app/mcp"
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "baselens": {
      "type": "http",
      "url": "https://baselens-api.vercel.app/mcp"
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "baselens": {
      "serverUrl": "https://baselens-api.vercel.app/mcp"
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "baselens": {
      "type": "http",
      "url": "https://baselens-api.vercel.app/mcp"
    }
  }
}

Tools this server provides (2)

Taken from the project documentation; the running server may differ.

base_free_gas_sample
Returns a free sample of current Base gas data.
base_catalog
Lists the available paid tools and endpoints.

What it does

x402 pay-per-call
Pay a quoted USDC amount per request with no key or signup.
Address and balance reads
Address snapshot and ERC-20 balances with decimals applied.
Token and contract checks
Owner, proxy implementation and Sourcify verification, with notes.
Transaction summaries
Decoded transfers, fees and status for a Base transaction.
On-chain pricing
Uniswap v3 USDC quote for any Base ERC-20.
Name resolution
Resolve Basenames and ENS names, or reverse-resolve an address.

Good for

  • Verify that a payment landed on Base
  • Check an ERC-20 balance for a wallet
  • Look up whether a token contract is upgradeable
  • Estimate current Base gas cost
  • Resolve a Basename to an address

Pricing

Paid

$0.001 to $0.004 USDC per call over x402; no API key

Prices change. Check baselens-api.vercel.app before you buy.

BaseLens FAQ

How much does a call cost?

Between $0.001 and $0.004 USDC, depending on the endpoint; gas is the cheapest at $0.001.

Do I need an API key?

No. You request a URL, receive a 402 quote, pay in USDC on Base and retry.

Are any tools free?

Yes. base_free_gas_sample and base_catalog are free, and there is a /free/gas sample.

Is this financial advice?

No. The site says results are read-only facts, and the contract check is not an audit.

Is BaseLens free?

No. BaseLens is a paid product.

How do I add BaseLens to Claude Code?

Run this command in your terminal: claude mcp add --transport http baselens https://baselens-api.vercel.app/mcp

What are the best alternatives to BaseLens?

The closest alternatives to BaseLens are Agent-Native Analytics, Google Ads + Meta Ads + SEO/GEO MCP, Solana MCP by Vybe, Tapetide - Indian Stock Market MCP and World Monitor.

Alternatives to BaseLens

  1. Open-source analytics app where an AI agent builds charts and dashboards from your data

    • Remote
    • Open source
    • 7.7K GitHub stars
    • Analytics and data
  2. Hosted MCP connector for managing Google Ads, Meta Ads, GA4 and Search Console from chat

    • 8 tools
    • Remote
    • Freemium
    • 8.1K GitHub stars
    • Marketing and SEO
  3. Remote MCP server exposing the Vybe Solana API to AI clients and code editors

    • 44 tools
    • Remote
    • 2.8K GitHub stars
    • Finance and payments
  4. Indian NSE and BSE stock market data for AI assistants through 48 MCP tools

    • 17 tools
    • Remote
    • Freemium
    • 150 GitHub stars
    • Finance and payments
  5. World Monitor

    MCP server

    Live geopolitical intelligence dashboard with an API and MCP server for agents

    • Remote
    • Freemium
    • Analytics and data
  6. Budget Tracker

    MCP server

    Local MCP expense ledger that logs receipts and mileage, splits VAT and prepares rebilling

    • 14 tools
    • Remote
    • Freemium
    • 2 GitHub stars
    • Finance and payments