Atlas / MCP servers / crazyrabbitltc / Etherscan

EtherscanSAFE

Name: Etherscan
Author: crazyrabbitltc

mcp/crazyrabbitltc/etherscan

MCP server by crazyrabbitltc · Audited 2026-10-08

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.

Verdict

SAFE

Grade

Trust score

89 /100

Exposed tools

6 6r · 0w · 0d

Transport

stdio

License

MIT

Stars

Overview

From the repository's own README, as read at the audited commit. Badges and raw HTML are left out.

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:

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

Install dependencies:

npm install

Create a .env file in the root directory:

ETHERSCAN_API_KEY=your_api_key_here

Build the project:

npm run build

Running the Server

Start the server:

npm start

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

Read from source at commit b966f2965655OBSERVED · 2026-10-08

Connect

Built from this server's own package name, version and transport as found in its source — not copied from anyone's documentation, so it cannot drift against a page we do not control. Replace the environment placeholders with a token scoped to the least it needs.

claude-code

claude mcp add mcp-etherscan-server --env ETHERSCAN_API_KEY=${ETHERSCAN_API_KEY} -- npx -y [email protected]

claude-desktop

{
  "mcpServers": {
    "mcp-etherscan-server": {
      "command": "npx",
      "args": [
        "-y",
        "[email protected]"
      ],
      "env": {
        "ETHERSCAN_API_KEY": "${ETHERSCAN_API_KEY}"
      }
    }
  }
}

Exposed tools (6)

6 read · 0 write · 0 destructive.

Tool	Risk	Description
`check-balance`	read	Check the ETH balance of an Ethereum address
`get-contract-abi`	read	Get the ABI for a smart contract
`get-ens-name`	read	Get the ENS name for an Ethereum address
`get-gas-prices`	read	Get current gas prices in Gwei
`get-token-transfers`	read	Get ERC20 token transfers for an Ethereum address
`get-transactions`	read	Get recent transactions for an Ethereum address

Trust audit

SAFEgrade B · trust 89/100 Nothing in the source contradicts what it says it does. Grade A is reserved for packages that have also passed the behavioural sandbox.

Layer	What it checks	Result
L0	Provenance & inventory	PASS
L1	Static analysis of the code	PASS
L2	Instruction surface (what it tells the agent)	PASS
L3	Class-specific surface	PASS
L4	Behavioural (sandbox)	SKIPPED

What the source does

Filesystem: none-observed
Network: declared (4 observation(s))
Shell: none-observed
Dependencies: not all pinned
Secrets in source: none-found

Findings (1)

LOWSupply chain · supply.unpinned · CWE-829, CWE-1357

package.json

@modelcontextprotocol/sdk, dotenv, ethers, zod, @types/node, typescript

Why it matters. 6 dependency range(s) float

Fix. pin exact versions or ship a lockfile

Gates applied: no_behavioural_pass.

Audited 2026-10-08 · audit v0.4.1 · source sha b966f2965655full audit observations/trust-audit/mcp-server/crazyrabbitltc__etherscan.json · Report an issue / request a re-scan

Audit history

Every audit this server has had. A grade with a past is a grade somebody is still checking.

Date	Source	Verdict	Grade	Score	Change
2026-10-08	`b966f2965655`	SAFE	B	89	first audit

Questions

What is the Etherscan MCP server?

What tools does Etherscan expose?

6 in total: 6 read-only, 0 that write, and 0 that can delete or overwrite. Every one is listed on this page with its risk.

Is Etherscan safe to connect to an agent?

The audit found nothing in the source that contradicts what it says it does, and graded it B (89/100). Grade A is held back for packages that have also passed a sandboxed behavioural run, which is why a clean server reads B.

What credentials does Etherscan need?

It reads ETHERSCAN_API_KEY from the environment. Give it a token scoped to the least it needs — an agent that can be talked into calling a tool can be talked into calling it with your credentials.

How does Etherscan run?

It speaks stdio, so it runs as a local process your client starts. It is published on npm as mcp-etherscan-server at 1.0.0.

How current is this page?

The grade is for one exact copy of the source (b966f2965655), read on 2026-10-08. The repository is watched and re-audited when it changes.

Source	crazyrabbitltc/mcp-etherscan-server
npm	`mcp-etherscan-server@1.0.0`
Transports	stdio
Credentials it reads	`ETHERSCAN_API_KEY`
License	MIT
Activity	pushed 646d ago