Server data from the Official MCP Registry
MCP server for Etherscan — Ethereum blockchain explorer API for AI assistants
MCP server for Etherscan — Ethereum blockchain explorer API for AI assistants
This Etherscan MCP server is well-structured with appropriate authentication handling and reasonable permissions for its blockchain query purpose. The code properly handles the optional API key, implements rate limiting for the free tier, and validates inputs via Zod. Minor concerns include broad error handling and the default placeholder API key, but these do not represent significant security risks. Supply chain analysis found 2 known vulnerabilities in dependencies (0 critical, 2 high severity). Package verification found 1 issue.
3 files analyzed · 7 issues found
Security scores are indicators to help you make informed decisions, not guarantees. Always review permissions before connecting any MCP server.
This plugin requests these system permissions. Most are normal for its category.
Add this to your MCP configuration file:
{
"mcpServers": {
"io-github-friendlygeorge-etherscan-mcp-server": {
"args": [
"-y",
"etherscan-mcp-server"
],
"command": "npx"
}
}
}From the project's GitHub README.
An MCP server for Etherscan — connect any MCP-compatible client to the Ethereum blockchain explorer.
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.
ETHERSCAN_API_KEY for 5 calls/sec and full results| Tool | Description |
|---|---|
get_eth_balance | Get native ETH balance for an address |
get_token_balances | Get all ERC-20 token balances for an address |
get_transaction | Get full details for a transaction by hash |
get_transactions_by_address | Get normal (external) transactions for an address |
get_erc20_transfers | Get ERC-20 token transfer events for an address |
get_internal_transactions | Get internal (contract-called) transactions for an address |
get_contract_abi | Get the ABI for a verified smart contract |
get_gas_price | Get current gas price oracle (slow/standard/fast in Gwei) |
npm install -g etherscan-mcp-server
Or run directly with npx:
npx -y etherscan-mcp-server
Add to your MCP client config (e.g. claude_desktop_config.json):
{
"mcpServers": {
"etherscan": {
"command": "npx",
"args": ["-y", "etherscan-mcp-server"]
}
}
}
Or with global install:
{
"mcpServers": {
"etherscan": {
"command": "etherscan-mcp-server"
}
}
}
Ask your AI assistant things like:
0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045?"0x..."0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48"get_eth_balanceETH Balance for 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045
247.3821 ETH
get_gas_price⛽ 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
*Estimated tx cost for 21,000 gas: 🐢 0.000263 ETH | 🚀 0.000397 ETH*
get_transactions_by_addressNormal Transactions for 0xd8dA...6045 (20 results, page 1)
- ✅ ↗ OUT 0.5 ETH · transfer — block 19,850,123 — 2026-06-05 — gas: 15.20 Gwei — hash: 0x4f8a2b9c3d1e5f7a...
- ✅ ↙ IN 1.2 ETH · transfer — block 19,849,876 — 2026-06-05 — gas: 14.80 Gwei — hash: 0x9c1d4e7f2a8b6c3d...
- ❌ ↗ OUT 0.0 ETH · swapExactTokensForETH — block 19,849,500 — 2026-06-05 — gas: 22.10 Gwei — hash: 0x2b7c9e1f4a3d8b5c...
get_contract_abiContract ABI for 0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48
- Functions: 28
- Events: 13
- Constructors: 1
- Fallback/Receive: 0
### Functions (showing first 25)
- `name()` → string (view)
- `symbol()` → string (view)
- `decimals()` → uint8 (view)
- `totalSupply()` → uint256 (view)
- `balanceOf(address)` → uint256 (view)
- `transfer(address,uint256)` → bool (nonpayable)
- `approve(address,uint256)` → bool (nonpayable)
- `transferFrom(address,address,uint256)` → bool (nonpayable)
...
The server automatically rate-limits requests to ~4 calls/second to stay within Etherscan's free tier (5 calls/sec). Without an API key, Etherscan limits you to 1 call/5 seconds.
To use a higher limit, sign up for a free Etherscan API key and set the ETHERSCAN_API_KEY environment variable:
{
"mcpServers": {
"etherscan": {
"command": "etherscan-mcp-server",
"env": {
"ETHERSCAN_API_KEY": "your_key_here"
}
}
}
}
git clone https://github.com/nova/etherscan-mcp-server.git
cd etherscan-mcp-server
npm install
npm run build
npm start
MIT
Be the first to review this server!
by Modelcontextprotocol · Developer Tools
Read, search, and manipulate Git repositories programmatically
by Modelcontextprotocol · Developer Tools
Web content fetching and conversion for efficient LLM usage
by Toleno · Developer Tools
Toleno Network MCP Server — Manage your Toleno mining account with Claude AI using natural language.