Etherscan

This MCP server provides Ethereum blockchain data tools by leveraging Etherscan's V2 API, giving you multi-network access with a single API key. You can query balances, transactions, token transfers, contract data, gas prices, ENS names, and more across 72+ networks, enabling powerful cross-chain tooling from a single MCP endpoint.

How to use

You connect to this server from an MCP client and use its tools to interact with Ethereum blockchain data. Start the local server and point your client to its stdio entry, then call the available tools like checking balances, listing recent transactions, or inspecting token data. You can also specify a target network for each request to access Ethereum mainnet, L2s, sidechains, and other networks with one API key.

How to install

Prerequisites you need before installing the server.

# Prerequisites
node -v  # should be >= 18
npm -v

# 1) Clone the repository
git clone https://example.com/mcp-etherscan-server.git
cd mcp-etherscan-server

# 2) Install dependencies
npm install

# 3) Create environment file with your API key
# Replace YOUR_API_KEY below with your actual Etherscan V2 API key
ETHERSCAN_API_KEY=YOUR_API_KEY

# 4) Build the project
npm run build

# Optional: run tests
npm run test

# 5) Start the server
npm start

The server is designed to run via a standard MCP client setup. You will configure the client to launch the local server process using a stdio configuration that points to the built index file and provides the required API key at runtime.

Server configuration and runtime notes

Environment variables shown for the runtime include the API key needed by the data provider. You should supply this key when starting the server or via your MCP client configuration.

{
  "mcpServers": {
    "etherscan": {
      "type": "stdio",
      "name": "etherscan",
      "command": "node",
      "args": ["/path/to/mcp-etherscan-server/build/index.js"],
      "env": {
        "ETHERSCAN_API_KEY": "your_api_key_here"
      }
    }
  }
}

Example usage in an MCP client

Once running, you can request data such as the balance of an address, recent transactions, or token holdings. You can also query contract information, gas prices, and network statistics by selecting the appropriate tool and providing the target network.

Notes and tips

The server uses Etherscan's V2 API, so all requests require the chainid parameter and a single API key works across 72+ networks. Build and start steps must be completed as shown to ensure the built index is used by the stdio process.

Available tools

check-balance

Get native token balance for any address across a chosen network.

get-transactions

Retrieve recent transactions with timestamps and values for an address.

get-token-transfers

List ERC20, ERC721, and ERC1155 token transfers with token details.

get-internal-transactions

Query internal transactions with trace details for an address.

get-mined-blocks

Show blocks mined by an address with rewards information.

get-beacon-withdrawals

Track ETH 2.0 staking withdrawals.

get-token-info

Fetch comprehensive token metadata and social links.

get-token-holders

List top holders and balances for a token.

get-token-portfolio

Get all token balances for a specific address.

get-contract-abi

Retrieve a contract ABI in JSON format.

get-contract-source

Fetch verified source code and related metadata.

get-contract-creation

Return creator address and deployment transaction for a contract.

verify-contract

Submit a contract for verification.

check-verification

Check the status of a contract verification.

verify-proxy

Verify a proxy contract.

get-verified-contracts

List recently verified contracts.

get-block-details

Get block information including hash, gas, and transactions.

get-block-reward

Retrieve block and uncle rewards.

get-gas-prices

Obtain current gas prices across networks.

get-network-stats

Access ETH supply, price, and market cap data.

get-daily-stats

Get historical daily transaction statistics.

get-logs

Query contract event logs with topic filtering.

list-networks

List all 72+ supported networks.

get-ens-name

Resolve an address to its ENS name.