Etherscan

🚀 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 histories, tracking ERC20 transfers, obtaining smart contract ABIs, monitoring gas prices, and resolving ENS names.

🚀 Quick Start

This server offers a range of tools for interacting with Ethereum blockchain data. To get started, follow the installation and running steps below.

✨ Features

• Balance Check: Retrieve the ETH balance of any Ethereum address.
• Transaction History: View recent transactions and their detailed information.
• Token Transfers: Track ERC20 token transfers and get token details.
• Contract ABI: Obtain the ABI of a smart contract for development purposes.
• Gas Prices: Monitor the current gas prices (Safe Low, Standard, Fast).
• ENS Resolution: Resolve an Ethereum address to an ENS name.

📦 Installation

Prerequisites

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

Steps

1. Clone the repository:

git clone [Your repository address]
cd mcp-etherscan-server

2. Install dependencies:

npm install

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

ETHERSCAN_API_KEY=Your_API_key

4. Build the project:

npm run build

💻 Usage Examples

Running the Server

Start the server:

npm start

The server will run on standard output, making it compatible with MCP clients such as Claude Desktop.

How it Works

This server implements the Model Context Protocol (MCP) and provides tools for interacting with Ethereum blockchain data through the Etherscan API. Each tool serves as an endpoint of MCP and can be invoked 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 transfers and 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: Associated ENS name (if available)

Using with Claude Desktop

To add this server to Claude Desktop:

1. Start the server using npm start.
2. In Claude Desktop:
   • Go to settings.
   • Navigate to the MCP server 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.
3. Now, the Etherscan tools will be available in your Claude conversations.

Usage Examples in Claude

You can use commands like:

Check the balance of 0x742d35Cc6634C0532925a3b844Bc454e4438f44e

or

Show recent transactions of vitalik.eth

📚 Documentation

Development

To add new features or modify existing ones:

1. The main server logic is located in src/server.ts.
2. The Etherscan API interaction is handled in src/services/etherscanService.ts.
3. After making changes, build the project using npm run build.

📄 License

This project is under the MIT License. For more details, please refer to LICENSE.