Etherscan MCP Server

by etherscan Your server? Claim it

answering

Etherscan is answering right now. Last checked 7 min ago. It exposes 16 tools.

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

Uptime history 23 days of history · worst day 99%

23 days agonow

99.5%

Uptime 24h

184 of 185 checks

Tools

read from the server

383 ms

Response time

average over 24h

API key

Access

streamable-http

What changed 26

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

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 99.9% 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 7 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

~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "etherscan-mcp": {
      "url": "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

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

This endpoint answered with an authorization challenge — the server is running, but you need an API key or OAuth to use it.

Available tools 16

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.

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	363 ms	8 min ago
https://mcp-keyless.etherscan.io/mcp	streamable-http	answering	395 ms	7 min ago

Alternatives to Etherscan

same job, measured the same way

Alchemy MCP Server

by alchemy

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

answering

Whale Alert API

by br0ski777

Track large on-chain whale transactions on Ethereum and Base. x402 micropayment.

1 tools answering

Log Reducer

by imankha

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

41 installs/wk local only

Kachink

by ahmadsl

Personal finance tracker — log transactions, view summaries, and browse a dashboard

answering

Auralogs

by auralogs

Read-only access to Auralogs production logs: search logs, inspect errors, review AI analyses.

7 tools answering

OeBB (Austrian Railways)

by slettmayer

OeBB (Austrian Railways) train data: stations, departures, connections, service alerts.

559 installs/wk local only

Itsoc MCP

by ankit512

Read-only MCP server over a local log-analysis backend; a client that computes no verdicts.

85 installs/wk local only

SukukFi

by sukuk

Live vault metrics and docs for SukukFi, Islamic trade finance on Berachain. Read-only.

5 tools answering

Etherscan — questions

Answers built from our own checks of this server.

What can Etherscan do?

It exposes 16 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 10 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 184 of 185 checks got a reply (99.5%), average response time 383 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 with the file path 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 383 ms on average, which is faster than 43% of all working MCP servers we measure. The comparison comes from our own checks across the whole registry, every 15 minutes.