The MCP Etherscan Server provides tools for interacting with Ethereum blockchain data via Etherscan's API using the Model Context Protocol. You can:
Check ETH balance for any Ethereum address
View transaction history with detailed information
Track ERC20 token transfers with token details
Fetch smart contract ABIs
Monitor current gas prices (Safe Low, Standard, Fast)
Resolve Ethereum addresses to associated ENS names
Uses environment variables for configuration, specifically for storing and accessing the Etherscan API key.
Provides tools for accessing Ethereum blockchain data through Etherscan's API, including checking ETH balances, viewing transaction history, tracking ERC20 transfers, fetching contract ABIs, monitoring gas prices, and resolving ENS names.
Provides a Node.js-based MCP server implementation for accessing Ethereum blockchain data.
MCP Etherscan Server
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.
Features
Balance Checking: Get ETH balance for any Ethereum address
Transaction History: View recent transactions with detailed information
Token Transfers: Track ERC20 token transfers with token details
Contract ABI: Fetch smart contract ABIs for development
Gas Prices: Monitor current gas prices (Safe Low, Standard, Fast)
ENS Resolution: Resolve Ethereum addresses to ENS names
Prerequisites
Node.js >= 18
An Etherscan API key (get one at https://etherscan.io/apis)
Installation
Clone the repository:
Install dependencies:
Create a
.env
file in the root directory:
Build the project:
Running the Server
Start the server:
The server will run on stdio, making it compatible with MCP clients like Claude Desktop.
How It Works
This server implements the Model Context Protocol (MCP) to provide tools for interacting with Ethereum blockchain data through Etherscan's API. Each tool is exposed as an MCP endpoint that can be called by compatible clients.
Available Tools
check-balance
Input: Ethereum address
Output: ETH balance in both Wei and ETH
get-transactions
Input: Ethereum address, optional limit
Output: Recent transactions with timestamps, values, and addresses
get-token-transfers
Input: Ethereum address, optional limit
Output: Recent ERC20 token transfers with token details
get-contract-abi
Input: Contract address
Output: Contract ABI in JSON format
get-gas-prices
Input: None
Output: Current gas prices in Gwei
get-ens-name
Input: Ethereum address
Output: Associated ENS name if available
Using with Claude Desktop
To add this server to Claude Desktop:
Start the server using
npm start
In Claude Desktop:
Go to Settings
Navigate to the MCP Servers section
Click "Add Server"
Enter the following configuration:
{ "name": "Etherscan Tools", "transport": "stdio", "command": "node /path/to/mcp-etherscan-server/build/index.js" }Save the configuration
The Etherscan tools will now be available in your Claude conversations
Example Usage in Claude
You can use commands like:
or
Development
To add new features or modify existing ones:
The main server logic is in
src/server.ts
Etherscan API interactions are handled in
src/services/etherscanService.ts
Build after changes:
npm run build
License
MIT License - See LICENSE file for details
remote-capable server
The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.
Provides Ethereum blockchain data tools via Etherscan's API, enabling users to check ETH balances, view transactions, track token transfers, fetch contract ABIs, monitor gas prices, and resolve ENS names.
- Features
- Prerequisites
- Installation
- Running the Server
- How It Works
- Using with Claude Desktop
- Development
- License
Related Resources
Related MCP Servers
- AsecurityAlicenseAqualityFacilitates interaction with Ethereum blockchain data via Etherscan's API, providing real-time access to balances, transactions, token transfers, contract ABIs, gas prices, and ENS name resolutions.Last updated -1426MIT License
- AsecurityAlicenseAqualityProvides tools for AI assistants to interact with the Ethereum blockchain through standard JSON-RPC methods, enabling queries for account balances, gas prices, and smart contract code.Last updated -310MIT License
- AsecurityAlicenseAqualityAn MCP server that provides access to Etherscan blockchain data APIs, allowing users to query Ethereum blockchain information through natural language.Last updated -62410MIT License
- AsecurityFlicenseAqualityA local Ethereum contract analysis tool that retrieves on-chain information, integrates Etherscan and RPC data, and automatically executes view functions to provide comprehensive contract insights.Last updated -23