# BaseLens

> BaseLens is a paid MCP server for finance and payments. Pay-per-call Base chain reads for agents: balances, prices, transfers and names. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Pricing:** Paid
- **Platforms:** API
- **Website:** https://baselens-api.vercel.app
- **MCP Registry name:** app.vercel.baselens-api/baselens
- **Categories:** finance and payments, analytics and data
- **Listing updated:** 2026-11-15

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

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

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://baselens-api.vercel.app/mcp
```

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

```json
{
  "mcpServers": {
    "baselens": {
      "url": "https://baselens-api.vercel.app/mcp"
    }
  }
}
```

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

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

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

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

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

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

## Tools

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

## 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

- [Agent-Native Analytics](https://ai-powered.com/mcp/agent-native-analytics): Agent-Native Analytics is an open-source MCP server for analytics and data.
- [Google Ads + Meta Ads + SEO/GEO MCP](https://ai-powered.com/mcp/google-ads-meta-ads-seo-geo-mcp): Google Ads + Meta Ads + SEO/GEO MCP is a freemium MCP server for marketing and seo.
- [Solana MCP by Vybe](https://ai-powered.com/mcp/solana-mcp-by-vybe): Solana MCP by Vybe is an MCP server for finance and payments.
- [Tapetide - Indian Stock Market MCP](https://ai-powered.com/mcp/tapetide-indian-stock-market-mcp): Tapetide - Indian Stock Market MCP is a freemium MCP server for finance and payments.
- [World Monitor](https://ai-powered.com/mcp/world-monitor): World Monitor is a freemium MCP server for analytics and data.
- [Budget Tracker](https://ai-powered.com/mcp/budget-tracker-2): Budget Tracker is a freemium MCP server for finance and payments.
- [CompanyData](https://ai-powered.com/mcp/companydata): CompanyData is a paid MCP server for analytics and data.
- [ChartAnt](https://ai-powered.com/mcp/chartant): ChartAnt is a freemium MCP server for design and media.

---
Source: https://ai-powered.com/mcp/baselens
