BaseLens is an MCP server published by app.vercel.baselens-api, hosted at baselens-api.vercel.app. When last checked on 2026-11-22 it was working: it answers and lists its tools. It declares 11 tools, including base_address, base_erc20_balance, base_token, base_tx, base_gas.
Base on-chain data for agents: balances, prices, transfers, Basenames, contracts. x402 pay-per-call.
86 connections through 4 shared values. Tap any node.
Squares are this server's values; dots are other servers sharing them. A shared address or publisher is a lead, not proof of a common operator.
Inferred from the host name and headers: what a server runs on, not who runs it.
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.
| Parameter | Type | Description |
|---|---|---|
| address * | string | 0x-prefixed Base address |
{
"name": "base_address",
"title": "/v1/address ($0.002 USDC)",
"description": "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.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"address"
],
"properties": {
"address": {
"type": "string",
"description": "0x-prefixed Base address"
}
}
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": true
}
}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.
| Parameter | Type | Description |
|---|---|---|
| token * | string | ERC-20 token contract on Base |
| address * | string | 0x-prefixed Base address |
{
"name": "base_erc20_balance",
"title": "/v1/erc20-balance ($0.002 USDC)",
"description": "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.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"token",
"address"
],
"properties": {
"token": {
"type": "string",
"description": "ERC-20 token contract on Base"
},
"address": {
"type": "string",
"description": "0x-prefixed Base address"
}
}
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": true
}
}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.
| Parameter | Type | Description |
|---|---|---|
| token * | string | Token contract on Base |
{
"name": "base_token",
"title": "/v1/token ($0.003 USDC)",
"description": "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.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"token"
],
"properties": {
"token": {
"type": "string",
"description": "Token contract on Base"
}
}
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": true
}
}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.
| Parameter | Type | Description |
|---|---|---|
| hash * | string | 0x-prefixed transaction hash on Base |
{
"name": "base_tx",
"title": "/v1/tx ($0.003 USDC)",
"description": "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.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"hash"
],
"properties": {
"hash": {
"type": "string",
"description": "0x-prefixed transaction hash on Base"
}
}
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": true
}
}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.
No parameters.
{
"name": "base_gas",
"title": "/v1/gas ($0.001 USDC)",
"description": "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.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {}
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": true
}
}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.
| Parameter | Type | Description |
|---|---|---|
| name | string | ENS or Basename, e.g. jesse.base.eth or vitalik.eth |
| address | string | Alternative: 0x address to reverse-resolve |
{
"name": "base_name",
"title": "/v1/name ($0.001 USDC)",
"description": "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.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"name": {
"type": "string",
"description": "ENS or Basename, e.g. jesse.base.eth or vitalik.eth"
},
"address": {
"type": "string",
"description": "Alternative: 0x address to reverse-resolve"
}
}
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": true
}
}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.
| Parameter | Type | Description |
|---|---|---|
| token * | string | ERC-20 token contract on Base |
{
"name": "base_price",
"title": "/v1/price ($0.003 USDC)",
"description": "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.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"token"
],
"properties": {
"token": {
"type": "string",
"description": "ERC-20 token contract on Base"
}
}
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": true
}
}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.
| Parameter | Type | Description |
|---|---|---|
| limit | string | Max transfers to return, ≤200 (default 50) |
| blocks | string | Lookback in blocks, 100–30000 (default 10000) |
| tokens | string | Optional comma-separated token contracts (max 5). Default USDC. |
| address * | string | 0x-prefixed Base address |
{
"name": "base_transfers",
"title": "/v1/transfers ($0.004 USDC)",
"description": "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.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"address"
],
"properties": {
"limit": {
"type": "string",
"description": "Max transfers to return, ≤200 (default 50)"
},
"blocks": {
"type": "string",
"description": "Lookback in blocks, 100–30000 (default 10000)"
},
"tokens": {
"type": "string",
"description": "Optional comma-separated token contracts (max 5). Default USDC."
},
"address": {
"type": "string",
"description": "0x-prefixed Base address"
}
}
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": true
}
}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.
| Parameter | Type | Description |
|---|---|---|
| address * | string | 0x-prefixed Base address |
{
"name": "base_contract",
"title": "/v1/contract ($0.003 USDC)",
"description": "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.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"address"
],
"properties": {
"address": {
"type": "string",
"description": "0x-prefixed Base address"
}
}
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": true
}
}Free sample: latest Base block number and base fee (gwei). Use it to test the connection.
No parameters.
{
"name": "base_free_gas_sample",
"title": "Free: Base gas sample",
"description": "Free sample: latest Base block number and base fee (gwei). Use it to test the connection.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {}
},
"annotations": {
"readOnlyHint": true
}
}Lists every BaseLens tool with price, inputs and the equivalent x402 HTTP URL.
No parameters.
{
"name": "base_catalog",
"title": "Free: BaseLens catalog and prices",
"description": "Lists every BaseLens tool with price, inputs and the equivalent x402 HTTP URL.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {}
},
"annotations": {
"readOnlyHint": true
}
}BaseLens: live Base (chain 8453) on-chain reads. Paid tools cost $0.001–$0.004 USDC on Base via x402 (send the payment in _meta["x402/payment"]; an x402-aware MCP client such as @x402/mcp does this automatically). Free: base_free_gas_sample, base_catalog. HTTP equivalents: https://baselens-api.vercel.app/llms.txt
Names, descriptions and schemas were written by the server and are shown as data.
Pattern matches on what the server declares. They show what it says it can do, not what it does.
None yet. Changes appear after a server's second daily check.