Etherscan MCP server
MCP server for Etherscan — Ethereum blockchain explorer API for AI assistants
0 stars61 downloads/wk
Reviews
Write oneNobody 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 postsRead from the package source without running it. The installed server may list more.
get_contract_abiGet 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_transfersGet ERC-20 token transfer events for an Ethereum address (token transfers in/out)
get_eth_balanceGet the native ETH balance for an Ethereum address (in ETH, not wei)
get_gas_priceGet the current gas price oracle from Etherscan — recommended gas prices for slow/standard/fast transaction speeds (in Gwei)
get_internal_transactionsGet internal transactions (contract calls) for an Ethereum address. These are transactions triggered by smart contracts, not direct EOA transfers.
get_token_balancesGet ERC-20 token balances for an Ethereum address (token name, symbol, contract, amount). Requires an Etherscan API key for best results.
get_transactionGet full details for a single transaction by its hash (from, to, value, gas, input data, status)
get_transactions_by_addressGet 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
- 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 archived
maint.archived
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
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 ETHgetgasprice
⛽ 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 GweiShortened. 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.