Etherscan

Provides Ethereum data tools via Etherscan API: balances, transactions, ERC20 transfers, contract ABIs, gas prices, and ENS resolution.

typescript

0

GitHub Stars

typescript

Language

7 months ago

First Indexed

3 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "mcp-mirror-crazyrabbitltc_mcp-etherscan-server": {
      "command": "node",
      "args": [
        "/path/to/mcp-etherscan-server/build/index.js"
      ],
      "env": {
        "ETHERSCAN_API_KEY": "YOUR_API_KEY"
      }
    }
  }
}

You can run an MCP server that exposes Ethereum blockchain data tools via Etherscan’s API. This server makes it easy to check balances, view transactions, track ERC20 transfers, fetch contract ABIs, monitor gas prices, and resolve ENS names from a single, MCP-compatible endpoint.

How to use

Start the server locally and connect with an MCP client. You will be able to request Ethereum data such as balance checks, recent transactions, token transfers, contract ABIs, current gas prices, and ENS name resolutions. Each tool is exposed as an MCP endpoint, so you can incorporate Ethereum data into your chats, automation, or development workflows without building your own data layer.

How to install

Prerequisites you need before installing and running are Node.js and an Etherscan API key.

Commands to set up and run the server you will perform in sequence:

# Prerequisites
node -v
npm -v

# Obtain an Etherscan API key and keep it secret
# Create a project directory and install dependencies
git clone [your-repo-url]
cd mcp-etherscan-server
npm install

# Configure environment variables
# Create a file named .env in the root with your API key
ETHERSCAN_API_KEY=your_api_key_here

# Build the project
npm run build

# Start the server (stdio transport for MCP clients)
npm start

Configuration and operation notes

This server uses an MCP-appropriate stdio interface for clients like Claude Desktop. A concrete example of how to run it from a client perspective is shown in a typical MCP configuration snippet.

{
  "name": "Etherscan Tools",
  "transport": "stdio",
  "command": "node /path/to/mcp-etherscan-server/build/index.js",
  "args": []
}

Tools exposed by the server

The server provides the following MCP endpoints to interact with Ethereum data through Etherscan’s API:

check-balance — Input: Ethereum address; Output: ETH balance in 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

Available tools

check-balance

Check the ETH balance for a given Ethereum address, returning both Wei and ETH amounts.

get-transactions

Retrieve recent transactions for a given address, with optional limit and details like timestamps and addresses.

get-token-transfers

List recent ERC20 token transfers for a given address, including token details.

get-contract-abi

Fetch the ABI for a specified smart contract address in JSON format.

get-gas-prices

Provide current Ethereum gas prices in Gwei for Safe Low, Standard, and Fast estimates.

get-ens-name

Resolve an Ethereum address to its associated ENS name when available.