Name: Etherscan
Author: xiaok

LABSCO SUMMARY

Block explorer data, without leaving the chat to open Etherscan.

Riding the v2 API is the right call — one key, many chains, no per-network server. Two things to check before you commit: chain coverage varies by endpoint, and Pro-tier calls are on the author's list rather than in the build. For read-only exploration on a supported chain, it is a short setup.

What it is

A dynamic MCP server over Etherscan's API and services. It targets the Etherscan v2 API, which serves many chains from one key, so on-chain lookups — balances, transactions, contract data — happen inside the conversation.

What you get

Access to the Etherscan v2 API surface from an MCP client, driven by your own Etherscan key
The multi-chain v2 endpoint, so the same server covers Etherscan's supported chain list rather than mainnet alone
Local inspection before wiring it into a client: npx fastmcp dev src/index.ts runs it in a terminal, npx fastmcp inspect src/index.ts opens the MCP Inspector web UI

Requirements

An Etherscan API key in ETHERSCAN_API_KEY. The npm package is private, so clone the repo and launch the TypeScript entry point directly — the documented Claude Desktop config runs npx tsx <YOUR_PATH_TO_PROJECT>/src/index.ts. Two limits to know before you plan around it: not every endpoint is available on every chain (Etherscan publishes the support grid), and the Pro API is listed as not yet supported. Version 1.0.0.

Setup effort

Build from source — git clone https://github.com/xiaok/etherscan-mcp.git

See installation options

USE CASES

01

Looking up an address without opening a block explorer

Ask about balances or recent activity for an address and keep the answer in the same conversation as your analysis.

02

Working across more than one chain with one key

Point questions at different supported chains through the same v2 endpoint instead of configuring a server per network.

BEFORE YOU INSTALL

What to know first

Requires

ETHERSCAN_API_KEY in your environment

Where it runs

The documented client runs the server on your machine.

INSTALLATION

Connect your client

You clone this one yourself.

Server setup

TERMINAL

git clone https://github.com/xiaok/etherscan-mcp.git
cd etherscan-mcp
npm install

MCP Clients

Claude Desktop

CLAUDE DESKTOP · JSON

{
  "mcpServers": {
    "etherscan_mcp": {
      "command": "npx",
      "args": [
        "tsx",
        "<YOUR_PATH_TO_PROJECT>/src/index.ts"
      ],
      "env": {
        "ETHERSCAN_API_KEY": "<YOUR_ETHERSCAN_API_KEY>"
      }
    }
  }
}

Etherscan