MCP.Market

Etherscan MCP server

by friendlygeorge·io.github.friendlygeorge/etherscan-mcp-server·v1.0.0

MCP server for Etherscan — Ethereum blockchain explorer API for AI assistants

C66/100grade C
What users say
No reviews yet
Be the first
Safety scan
C66/100

full report

Adoption
New

0 stars61 downloads/wk

Reviews

Write one

Nobody has reviewed Etherscan yet.

If you have run it, two minutes of your experience saves the next person an afternoon.

Etherscan tools (8)

write = sends, deletes, buys or posts

Read from the package source without running it. The installed server may list more.

  • get_contract_abi

    Get the ABI (Application Binary Interface) for a verified smart contract. The ABI is a JSON array describing the contract's functions and events — required for calling contract methods.

  • get_erc20_transfers

    Get ERC-20 token transfer events for an Ethereum address (token transfers in/out)

  • get_eth_balance

    Get the native ETH balance for an Ethereum address (in ETH, not wei)

  • get_gas_price

    Get the current gas price oracle from Etherscan — recommended gas prices for slow/standard/fast transaction speeds (in Gwei)

  • get_internal_transactions

    Get internal transactions (contract calls) for an Ethereum address. These are transactions triggered by smart contracts, not direct EOA transfers.

  • get_token_balances

    Get ERC-20 token balances for an Ethereum address (token name, symbol, contract, amount). Requires an Etherscan API key for best results.

  • get_transaction

    Get full details for a single transaction by its hash (from, to, value, gas, input data, status)

  • get_transactions_by_address

    Get the normal (external) transactions for an Ethereum address, newest first. Includes value, gas, from/to, method.

Public scan report

scanner v0.1.9 · 2026-09-27 · same rubric, same numbers if you re-run it

1 high
  • Code scan6 source files scanned25/25
  • –Live reliabilityno gateway calls yet and no remote to proben/a
  • –Tool poisoningtools not inspected (local package is not executed); not countedn/a
  • Auth qualitylocal package, no credentials required12/15
  • Maintenancerepository archived0/15
  • Maintainer identityregistry namespace matches repository owner6/10

Findings (1)

  • highRepository is archivedmaint.archived
Overall 66/100. Components that don't apply are left out of the denominator. Any critical finding is an F.RubricAppeal a findingJSON

How Etherscan compares

Against every graded MCP server, from our own scans and uptime checks. Updated after each scan run.

Safety score
66/100
higher than 23% of 48,255 servers
Tools
8
the typical server has 7
Tools that change things
0%
typical: 0%. Fewer write tools means less an agent can break
Downloads a week
61
more than 49% of 12,191 servers with a package

What its tools let an agent do: 8 read

Install Etherscan in Claude Code, Cursor or VS Code

Runs npx -y etherscan-mcp-server on your machine. Read the scan report first; the gateway never runs local packages.

claude mcp add etherscan-mcp-server -- npx -y etherscan-mcp-server
Add to Cursor

What the publisher says

From the Etherscan repository's README, as published. We do not edit it. Read it on GitHub

Etherscan MCP Server

An MCP server for Etherscan — connect any MCP-compatible client to the Ethereum blockchain explorer.

What is this?

An MCP (Model Context Protocol) server that gives AI assistants and agents access to Etherscan's Ethereum blockchain explorer API — ETH balances, ERC-20 token balances, transaction history, contract ABIs, and gas prices — through natural language.

Use it with Claude Desktop, Cursor, Windsurf, Cline, Continue, or any MCP-compatible client to inspect wallets, audit contracts, and analyze on-chain activity.

Why use this?

  • No API key required — works out of the box with Etherscan's free tier (limited to ~1 call/5s without a key)
  • Optional API key support — set ETHERSCANAPIKEY for 5 calls/sec and full results
  • 8 built-in tools — covers the most common on-chain queries
  • Clean markdown output — results read naturally in chat
  • Rate-limited automatically — respects free tier limits, retries on 429

Tools

Quick Start

1. Add to your MCP client

Add this to your MCP client config (e.g. claudedesktopconfig.json):

{
  "mcpServers": {
    "etherscan": {
      "command": "npx",
      "args": ["-y", "etherscan-mcp-server"]
    }
  }
}

That's it. npx downloads and runs it automatically. For higher rate limits, get a free API key at etherscan.io/apis and add it:

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

2. Use it

Ask your AI assistant things like:

  • "What's the ETH balance of vitalik.eth's address 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045?"
  • "Show me the ERC-20 token balances for that address"
  • "Get details for transaction 0x..."
  • "List the last 20 normal transactions for this address"
  • "Show me all USDT transfers to this wallet"
  • "Fetch the ABI for the USDC contract 0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48"
  • "What are current gas prices on Ethereum mainnet?"

Example Output

getethbalance

ETH Balance for 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045

247.3821 ETH

getgasprice

⛽ Etherscan Gas Price Oracle

- Safe Low (🐢): 12.50 Gwei
- Standard (🚗): 15.20 Gwei
- Fast (🚀): 18.90 Gwei

- Last Block: 19850000
- Gas Used Ratio: 0.512
- Suggested Base Fee: 13.40 Gwei

Shortened. The full README is on GitHub.

Nothing above is checked by us. What we check is on the safety report.

Etherscan: common questions

Is Etherscan MCP server safe?
With care: it is graded C, so read the findings first (66/100). Read the Etherscan safety report
How do I install Etherscan?
It runs on your machine. Copy the Claude Code, Cursor, VS Code or Claude Desktop config from the install section.
Does Etherscan need an API key?
Not as far as the registry entry and our scan can tell: no credentials are declared or required.
Is Etherscan maintained?
The last commit was 146 days ago (2026-06-11). The latest release is v1.0.0.
How does Etherscan compare with other MCP servers?
safety score 66/100 (higher than 23% of 48,255 servers); tools 8 (the typical server has 7); tools that change things 0% (typical: 0%. Fewer write tools means less an agent can break). Full comparison.

More from friendlygeorge →