Integration

Etherscan integration

Etherscan is the leading blockchain explorer, search, API, and analytics platform for Ethereum and EVM-compatible chains. The V2 API unifies 60+ chains (Ethereum, BNB Smart Chain, Polygon, Arbitrum, Optimism, Base, Avalanche, Linea, Scroll, Blast, etc.) under a single account and API key. Every endpoint takes a chainid query param so the same call works across networks. Provides on-chain data such as native and ERC-20/721/1155 balances, normal/internal/token transactions, smart contract ABIs and source code, transaction status, block rewards and countdowns, event logs with topic filtering, gas oracle and gas estimates, and Ether supply/price stats.

Connect Etherscan How integrations work

Ask it in chat

Say what should happen.
The workflow builds itself.

When this happens, do that in Etherscan.Built from the 23 Etherscan tools below, on the connection you add once.

Common Etherscan use cases

forensics
balance gating
treasury monitoring
indexer
debugging
wallet UX
accounting
attribution
call encoding
price display

What you can do with Etherscan

Each of these is one operation on one endpoint, available both as a workflow step and as a tool an AI agent can call on its own. Nothing bundles several operations into one action, so what a run did stays readable afterwards.

Most endpoints run on the free plan. A few, mainly the ones that publish on your behalf, need a paid plan.

Balance, 2 operations

get_native_balanceGet native balanceGETGets the native token balance (ETH, BNB, MATIC, etc.) of an EVM address on any of the 60+ chains supported by Etherscan V2.
get_native_balance_multiGet native balance multiGETGets the native token balance of up to 20 addresses in a single Etherscan call.

Internal transaction, 2 operations

list_internal_transactionsList internal transactionsGETLists internal contract-to-contract calls (traces) involving an EVM address.
list_internal_transactions_by_hashList internal transactions by hashGETLists internal calls performed by a specific transaction (looked up by tx hash).

Block, 1 operation

get_block_by_timestampGet block by timestampGETFinds the block number closest to a given Unix timestamp.

Block countdown, 1 operation

get_block_countdownGet block countdownGETEstimates the time remaining until a future block number is reached.

Block reward, 1 operation

get_block_rewardGet block rewardGETReturns the miner/validator reward and uncle rewards for a given block.

Contract abi, 1 operation

get_contract_abiGet contract abiGETFetches the verified ABI JSON of a smart contract by address.

Contract creation, 1 operation

get_contract_creationGet contract creationGETReturns the deployer, creation tx, block, and timestamp of up to 5 smart contracts.

Contract source, 1 operation

get_contract_source_codeGet contract source codeGETFetches the verified source code, ABI, and compiler metadata of a smart contract.

Erc20 balance, 1 operation

get_erc20_token_balanceGet erc20 token balanceGETGets the ERC-20 token balance of an address for a specific token contract.

Erc20 supply, 1 operation

get_token_supplyGet token supplyGETGets the current total supply of an ERC-20 token (raw units).

Erc20 transfer, 1 operation

list_erc20_transfersList erc20 transfersGETLists ERC-20 Transfer events involving an address, optionally filtered by token contract.

Erc721 transfer, 1 operation

list_erc721_transfersList erc721 transfersGETLists ERC-721 NFT Transfer events for an address, optionally scoped to one collection.

Eth price, 1 operation

get_eth_priceGet eth priceGETReturns the latest ETH/USD and ETH/BTC price quoted by Etherscan.

Eth supply, 1 operation

get_eth_supplyGet eth supplyGETReturns the total Ether (or native token) supply on the chain in wei.

Event log, 1 operation

get_event_logsGet event logsGETLists event logs filtered by contract address, block range, and up to four indexed topics with boolean operators.

Gas estimate, 1 operation

get_gas_estimateGet gas estimateGETEstimates how long a transaction at a given gas price will take to confirm.

Gas oracle, 1 operation

get_gas_oracleGet gas oracleGETReturns current gas price recommendations (safe / propose / fast) and EIP-1559 base fee.

Token info, 1 operation

get_token_infoGet token infoGETReturns metadata, social links, and USD price for an ERC-20/721/1155 token. PRO endpoint.

Transaction, 1 operation

list_normal_transactionsList normal transactionsGETLists normal (externally-signed) transactions for an EVM address with block range and pagination.

Transaction receipt, 1 operation

get_transaction_receipt_statusGet transaction receipt statusGETReturns the receipt status flag (success/fail) of a transaction.

Transaction status, 1 operation

get_transaction_statusGet transaction statusGETReports the EVM execution status (success / revert reason) of a transaction.

Use Etherscan from Claude Code, Cursor or Codex

Connect Etherscan in LiveContext, create an API key in Settings, then add the LiveContext MCP server to your client. Its Etherscan operations become tools the client can call, next to every other integration you connected.

Claude Code

claude mcp add --transport http livecontext https://livecontext.ai/mcp --header "X-API-Key: YOUR_API_KEY"

Codex (~/.codex/config.toml)

[mcp_servers.livecontext]
url = "https://livecontext.ai/mcp"

[mcp_servers.livecontext.http_headers]
"X-API-Key" = "YOUR_API_KEY"

Cursor, Claude Desktop and other JSON configs

{
  "mcpServers": {
    "livecontext": {
      "type": "http",
      "url": "https://livecontext.ai/mcp",
      "headers": {
        "X-API-Key": "YOUR_API_KEY"
      }
    }
  }
}

Set up the MCP server step by step

How to connect Etherscan

Create your workspace
Sign up free. Nothing to install.
Connect Etherscan once
Add your Etherscan connection in Settings. Every tool from this integration reuses it, and secrets are encrypted at rest and visible only to you.
Describe the job in chat
The workflow builds itself in front of you and picks the endpoints it needs. Drag the steps yourself on the canvas whenever you would rather be explicit.

Etherscan integration FAQ

What can you do with the Etherscan integration?

LiveContext exposes 23 operations on Etherscan, covering balance, internal transaction, block and block countdown. Common uses include forensics, balance gating and treasury monitoring.