Etherscan MCP Server

by etherscan Your server? Claim it

answering

Etherscan is answering right now. Last checked 4 min ago. It exposes 17 tools.

Read-only Etherscan V2 blockchain data: balances, transactions, transfers, tokens, contracts, logs.

Uptime history 69 days of history · worst day 84%

69 days agonow

100.0%

Uptime 24h

183 of 183 checks

Tools

read from the server

481 ms

Response time

average over 24h

API key

Access

streamable-http

What changed 46

Every tool that appeared, vanished or quietly changed what it asks for. Recorded since 5 September 2026. No other catalogue keeps this.

23 Oct a tool appeared resolve_ens_name

12 Oct 3 tools changed the parameters they ask for get_internal_transactions, get_token_transfers, get_transactions

17 Sep 16 tools changed the parameters they ask for get_block_by_timestamp, get_contract_abi, get_contract_creation and 13 more

10 Sep 14 tools changed the parameters they ask for15 times that day get_block_by_timestamp, get_contract_abi, get_contract_creation and 11 more

10 Sep 2 tool descriptions were rewritten get_contract_creation, get_supported_chains

10 Sep a tool changed version

5 Sep 5 tools disappeared get_address_labels, get_funded_by, get_token_balances and 2 more

5 Sep 2 tools changed the parameters they ask for get_logs, get_token_transfers

5 Sep a tool appeared render_etherscan_widget

and 1 more, back to 5 September 2026

Etherscan does not always answer

Over the last week it answered 97.7% of our checks. We check every 15 minutes, so you hear about the next outage within the hour — not from your users.

Connect this server

Endpoint below is the one we actually reach during checks — not the one copied from a README. Last verified 4 min ago.

Claude Code Claude Desktop Codex Cursor VS Code

run in your terminal

claude mcp add etherscan-mcp --transport http https://mcp.etherscan.io/mcp

Settings → Connectors → Add custom connector, then paste this address

https://mcp.etherscan.io/mcp

~/.codex/config.toml

[mcp_servers.etherscan-mcp]
url = "https://mcp.etherscan.io/mcp"

.cursor/mcp.json

{
  "mcpServers": {
    "etherscan-mcp": {
      "url": "https://mcp.etherscan.io/mcp"
    }
  }
}

.vscode/mcp.json

{
  "servers": {
    "etherscan-mcp": {
      "type": "http",
      "url": "https://mcp.etherscan.io/mcp"
    }
  }
}

This endpoint answered with an authorization challenge. The server is running, but you need an API key from its owner to call it.

This server publishes 1 more address. The block above uses the one we reach during checks; the full list is under Endpoints below, and the author may intend a particular one for your client.

Available tools 17

Read directly from the server with tools/list, grouped by what they act on. If a tool disappears, we record the date.

transaction

get_transaction_by_hash

Get the full transaction object for a transaction hash (from, to, value, input data, gas, gas price, nonce, block number/hash, transaction index). Returns null if the hash is unknown.

get_transaction_receipt

Get the transaction receipt for a transaction hash (execution status, gas used, cumulative gas used, effective gas price, logs, and the created contract address for deployments). Returns null if the hash is unknown or the transaction is still pending.

get_transaction_receipt_status

Get the receipt status of a transaction (1 = success, 0 = failed). Post-Byzantium only.

get_transaction_status

Get the contract execution status of a transaction (detects failed/erroring executions).

contract

get_contract_abi

Get the verified ABI (JSON) for a contract address.

get_contract_creation

Get the creator address and creation transaction hash for up to 5 contract addresses. The multi-kilobyte creation bytecode is omitted by default to keep responses small; set include_creation_bytecode=true to include it.

get_contract_source

Get the verified source code and metadata for a contract address.

block

get_block_by_timestamp

Get the block number closest to a given Unix timestamp (seconds).

gas

get_gas_oracle

Get current gas price recommendations (safe / propose / fast) from the gas tracker.

internal

get_internal_transactions

Get internal transactions for an address, or by a specific parent transaction hash.

logs

get_logs

Search event logs by contract address and/or topics over a block range. Topics are 32-byte hex values; topic0 is usually the keccak256 event-signature hash. Adjacent-topic operators (and/or) combine multiple topic filters. Provide 'address' and/or at least one topic.

native

get_native_balance

Get the native coin (e.g. ETH) balance of an address, in wei.

render

render_etherscan_widget

Present exact facts returned by Etherscan data tools in a fast explorer-style card. Call the relevant Etherscan data tool first and copy only supported values into this tool. Never invent scores, risk labels, historical prices, forecasts, or audit conclusions.

resolve

resolve_ens_name

Resolve an ENS name (or onchain subdomain, e.g. etherscan.eth or gm.etherscan.eth) to its Ethereum address. Ethereum mainnet only. Offchain names that require CCIP Read / wildcard resolution (e.g. *.base.eth) are not supported.

supported

get_supported_chains

Get the chains / chain IDs supported by the Etherscan V2 API. In the hosted (proxy) deployment this returns a bundled snapshot shipped with the server, refreshed when the package is updated; in direct/stdio mode it queries the live chain-list endpoint. A chain's absence from the returned list is not proof that it lacks live support.

token

get_token_transfers

Get token transfer events for an address, optionally filtered by token contract. Select the token standard: erc20 (fungible, default), erc721 (NFT), or erc1155 (multi-token).

transactions

get_transactions

Get the list of normal (external) transactions for an address.

Tools removed

Tools this server used to expose. Anything built against them stopped working on the day they went.

get_address_labels

removed 5 Sep 2026

get_funded_by

removed 5 Sep 2026

get_token_balances

removed 5 Sep 2026

get_token_info

removed 5 Sep 2026

get_token_top_holders

removed 5 Sep 2026

Endpoints

URL	Transport	State	Latency	Checked
https://mcp.etherscan.io/mcp	streamable-http	needs key	483 ms	5 min ago
https://mcp-keyless.etherscan.io/mcp	streamable-http	answering	478 ms	4 min ago

Alternatives to Etherscan

same job, measured the same way

Tanod Chain

by tanod

EVM and Solana reads: balances, tokens, eth_call, logs, receipts, gas, blocks, transactions, ENS.

40 tools answering

Ankr Agent RPC

by w3tech

Read chain data on 200+ networks and Sui: transactions, logs, balances, objects, ABI-decoded.

329 installs/wk 25 tools answering

Alchemy MCP Server

by alchemy

Blockchain data across 100+ chains: token prices, NFTs, transfers, simulation, traces, Solana DAS

answering

Agent Data Tools: Chain data

by nutshell2000

116 tools: balances, blocks, gas, txs and logs on 5 EVM chains, plus Bitcoin. 25 free calls.

120 tools answering

Free Base Blockchain Tools

by agentsapi

13 free Base tools: address labels, tx explain, balances, receipts, gas, logs, bytecode.

14 tools answering

LogCarver

by caiderek

Read-only MCP server that finds deleted SQL Server rows from the transaction log (fn_dblog).

local only

Log Reducer

by imankha

Reduces log files for AI consumption — 50-90% token reduction via 18 deterministic transforms.

22 installs/wk local only

Contractor Foreman by Cotlet

by cotlet

Projects, estimates, daily logs and invoices in Contractor Foreman.

296 installs/wk 106 tools answering

Etherscan — questions

Answers built from our own checks of this server.

What can Etherscan do?

It exposes 17 tools, read directly from the server on our last check. Among them: get_block_by_timestamp, get_contract_abi, get_contract_creation, get_contract_source, get_gas_oracle, get_internal_transactions and 11 more. The full list with descriptions is on this page — we take it from the server itself via tools/list, not from a README. How MCP servers expose tools in the first place →

What is Etherscan mostly used for?

Its tools cluster around transaction and contract. That is what this server is built to work with — the grouping comes from the actual tool names, not from a category we assigned.

Is Etherscan working right now?

We send a real MCP handshake every 15 minutes. Over the last 24 hours 183 of 183 checks got a reply (100.0%), average response time 481 ms. The bar chart above shows every period we have measured.

Did Etherscan ever remove tools?

Yes. get_address_labels, get_funded_by, get_token_balances, get_token_info and 1 more are no longer exposed — we recorded the date each one disappeared. A tool vanishing usually means a breaking change for anything that depended on it.

How do I connect Etherscan?

Copy the ready config from this page. We generate it for Claude Code, Claude Desktop, Codex, Cursor and VS Code, each in the form that client actually reads. It is a remote server, so there is nothing to install — the client connects to the address. You will need your own key: it refuses anonymous clients.

Does Etherscan need an API key?

Yes. Every time we knock, Etherscan answers with an authorization challenge instead of its tool list — that is how we know it is running and gated rather than broken. Bring your own credentials and it will talk.

How fast is Etherscan?

It answers our handshake in 481 ms on average, which is faster than 28% of all working MCP servers we measure. The comparison comes from our own checks across the whole registry, every 15 minutes.