MCP Etherscan Server
@crazyrabbitLTC
An MCP (Model Context Protocol) server that provides Ethereum blockchain data tools via Etherscan's API. Features include checking ETH balances, viewing transaction history, tracking ERC20 transfers, fetching contract ABIs, monitoring gas prices, and resolving ENS names.
Overview
What is MCP Etherscan Server?
MCP Etherscan Server is an MCP (Model Context Protocol) server that provides Ethereum blockchain data tools via Etherscan's API. It is designed for developers and users who need to query on-chain information such as ETH balances, transaction history, ERC20 transfers, contract ABIs, gas prices, and ENS names through MCP-compatible clients like Claude Desktop.
How to use MCP Etherscan Server?
Install Node.js >=18, obtain an Etherscan API key from https://etherscan.io/apis, clone the repository, run npm install, create a .env file with ETHERSCAN_API_KEY=your_key, then build with npm run build and start with npm start. The server runs on stdio and can be added to Claude Desktop by configuring a new MCP server with the command node /path/to/build/index.js.
Key features of MCP Etherscan Server
- Check ETH balance for any Ethereum address
- View recent transactions with timestamps and values
- Track ERC20 token transfers with token details
- Fetch smart contract ABIs in JSON format
- Monitor current gas prices (Safe Low, Standard, Fast)
- Resolve Ethereum addresses to ENS names
Use cases of MCP Etherscan Server
- Querying an address’s ETH balance during a conversation
- Reviewing recent transaction history for an address or ENS name
- Retrieving a contract ABI for development or debugging
- Checking current gas prices before submitting a transaction
- Resolving an Ethereum address to its ENS name
FAQ from MCP Etherscan Server
What are the prerequisites to run MCP Etherscan Server?
Node.js version 18 or higher and a valid Etherscan API key are required.
How do I get an Etherscan API key?
You can obtain a free API key by signing up at https://etherscan.io/apis.
How do I run the server after installation?
Run npm start from the project root. The server will listen on stdio and is ready to be used by MCP clients.
What tools does MCP Etherscan Server expose?
It exposes six tools: check-balance, get-transactions, get-token-transfers, get-contract-abi, get-gas-prices, and get-ens-name.
How do I use MCP Etherscan Server with Claude Desktop?
Start the server, then in Claude Desktop go to Settings → MCP Servers → Add Server, and enter the configuration with transport stdio and command pointing to the built index.js file.
