BaseLens

app.vercel.baselens-apiPublished by baselens-api.vercel.appOfficial publisherv1.1.0Updated Oct 30, 2026

Base on-chain data for agents: balances, prices, transfers, Basenames, contracts. x402 pay-per-call.

VerifiedStreamable HTTPWeb executableDatabasesFinance

Overview

AI-generated overview

Read-only Base (chain 8453) on-chain data for assistants: balances, token facts, prices, transfers, Basenames, contracts and gas, paid per call in USDC via…

What you can do
  • Look up addresses and balances: address snapshot (EOA, contract or EIP-7702), ETH and native USDC balance, ERC-20 balances for any token
  • Inspect tokens and contracts: name, symbol, decimals, supply, owner, EIP-1967 proxy implementation, Sourcify verification status
  • Check transactions and activity: human-readable transaction summary with decoded ERC-20 transfers, recent transfers in and out of an address
  • Resolve names: Basename or ENS to address, and reverse lookup with avatar record
  • Read market and network state: on-chain Uniswap v3 USDC price quote, current gas and EIP-1559 fee suggestions
  • Discover tools and test the connection with a free gas sample and a tool catalog
When to use it
Useful when an assistant needs to answer questions about Base wallets, tokens, contracts, payments or gas without a separate block explorer or indexer, especially for verifying that a payment landed or checking a token's owner and upgradeability.
Requirements
Remote streamable HTTP endpoint; no local install, account or API key declared. Paid tools require USDC on Base sent via x402, normally handled by an x402-aware MCP client; otherwise the payment must be supplied in the request metadata.
Before you install
Most tools cost $0.001–$0.004 USDC per call on Base, so usage spends real funds; only the free gas sample and catalog are free. The server returns read-only facts, not audits or advice, and contract verification status is not a safety guarantee. Payment handling depends on the client's x402 support.

Installation

In SourceWeft

  1. Open BaseLens in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Use with an agent

Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.

Read https://sourceweft.com/mcp/app.vercel.baselens-api%2Fbaselens/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config.

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

Tools

11

base_address

/v1/address ($0.002 USDC)

Base (chain 8453) address snapshot: EOA vs contract vs EIP-7702, ETH balance, nonce, code size and native USDC balance, at the latest block. Costs $0.002 USDC on Base via x402.

Parametersaddressrequired

base_erc20_balance

/v1/erc20-balance ($0.002 USDC)

ERC-20 balance of any address for any token on Base, with symbol and decimals already applied (raw and human-readable). Costs $0.002 USDC on Base via x402.

Parameterstokenrequiredaddressrequired

base_token

/v1/token ($0.003 USDC)

Token facts on Base: name, symbol, decimals, total supply, contract code size, owner() and EIP-1967 proxy implementation, plus plain-language notes (upgradeable? owner renounced?). Read-only facts, not advice. Costs $0.003 USDC on Base via x402.

Parameterstokenrequired

base_tx

/v1/tx ($0.003 USDC)

Human-readable summary of a Base transaction: status, block time, from/to, value, total fee (incl. L1 fee), and decoded ERC-20 Transfer events with token symbols and amounts. Handy to verify a payment landed. Costs $0.003 USDC on Base via x402.

Parametershashrequired

base_gas

/v1/gas ($0.001 USDC)

Current Base gas: base fee, gas price, suggested EIP-1559 max fee and priority fee (gwei), block fullness, and cost of a plain ETH transfer. Costs $0.001 USDC on Base via x402.

Takes no parameters.

base_name

/v1/name ($0.001 USDC)

Resolve a Basename (name.base.eth) or ENS name to its Base/Ethereum address, or reverse-resolve an address to its primary ENS/Basename. Includes avatar record. Costs $0.001 USDC on Base via x402.

Parametersnameaddress

base_price

/v1/price ($0.003 USDC)

On-chain USDC price of any Base ERC-20: executable Uniswap v3 quote for 1 whole token (direct USDC pool or via WETH, best fee tier). No third-party price API. Costs $0.003 USDC on Base via x402.

Parameterstokenrequired

base_transfers

/v1/transfers ($0.004 USDC)

Recent ERC-20 transfers in and out of an address on Base for up to 5 tokens (default USDC), newest first, over the last ~10k blocks (max 30k). Check incoming payments or wallet activity. Costs $0.004 USDC on Base via x402.

Parameterslimitblockstokensaddressrequired

base_contract

/v1/contract ($0.003 USDC)

Contract check on Base: is it a contract, code size, owner(), proxy implementation, and whether the source (and implementation) is verified on Sourcify, plus plain-language notes. Not an audit. Costs $0.003 USDC on Base via x402.

Parametersaddressrequired

base_free_gas_sample

Free: Base gas sample

Free sample: latest Base block number and base fee (gwei). Use it to test the connection.

Takes no parameters.

base_catalog

Free: BaseLens catalog and prices

Lists every BaseLens tool with price, inputs and the equivalent x402 HTTP URL.

Takes no parameters.

Version history

1
  1. v1.1.0LatestOct 30, 2026

Score

83% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 daysRequired25 pts
  • Auth declaredRequired10 pts
  • Tools listedRequired15 pts
  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts

    Declare a GitHub repository with a README, or serve resource_documentation in the OAuth protected-resource metadata.

  • LicenseNot applicable

    A hosted service is used under its provider's terms, so no license is expected here. This check is left out of the percentage.