Etherscan Tools

🚀 MCP Etherscan Server

A server based on the Model Context Protocol (MCP) that provides Ethereum blockchain data tools through the Etherscan API. It enables functions such as checking ETH balances, viewing transaction records, tracking ERC20 transfers, obtaining smart contract ABIs, monitoring gas prices, and resolving ENS names.

✨ Features

• Balance Inquiry: Retrieve the ETH balance of any Ethereum address.
• Transaction Records: View recent transaction records and detailed information.
• Token Transfers: Track ERC20 token transfer records and their token details.
• Contract ABI: Obtain the ABI (Application Binary Interface) of smart contracts for development.
• Gas Price Monitoring: Check the current gas prices (Safe Low, Standard, Fast).
• ENS Resolution: Resolve Ethereum addresses to ENS names.

📦 Prerequisites

• Node.js >= 18
• An Etherscan API key (Get it from: https://etherscan.io/apis)

📦 Installation

1. Clone the repository:

git clone [your-repo-url]
cd mcp-etherscan-server

2. Install dependencies:

npm install

3. Create a .env file in the root directory:

ETHERSCAN_API_KEY=your_api_key_here

4. Build the project:

npm run build

💻 Usage Examples

Start the server

npm start

The server will run on standard input/output, making it compatible with MCP clients (e.g., Claude Desktop).

🔧 Technical Details

This server implements the Model Context Protocol (MCP) and provides tools to interact with blockchain data through the Etherscan API. Each tool serves as an MCP endpoint that can be called by compatible clients.

Available Tools

1. check-balance

   • Input: Ethereum address
   • Output: ETH balance (in Wei and ETH)

2. get-transactions

   • Input: Ethereum address, optional limit
   • Output: Recent transaction records, including timestamps, values, and addresses

3. get-token-transfers

   • Input: Ethereum address, optional limit
   • Output: Recent ERC20 token transfer records and their token details

4. get-contract-abi

   • Input: Contract address
   • Output: JSON format of the contract ABI

5. get-gas-prices

   • Input: None
   • Output: Current gas prices (in Gwei)

6. get-ens-name

   • Input: Ethereum address
   • Output: Available associated ENS names

🚀 Integration with Claude Desktop

To add this server to Claude Desktop:

1. Start the server using npm start.

2. In Claude Desktop:

   • Open the settings.
   • Navigate to the MCP server section.
   • Click "Add Server".
   • Enter the following configuration:

     {
       "name": "Etherscan Tools",
       "transport": "stdio"
     }