MCPgee
MCPgee
MCPgeeMCPgee

Etherscan

v1.0.0•Finance & Fintech•stable

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

mcp-etherscan-servermcpai-integration
Share:
30
Stars
0
Downloads
0
Weekly
0/5
View on GitHub

What is Etherscan?

Etherscan is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to 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, fet...

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

This server falls under the Finance & Fintech category on MCPgee, the world's largest MCP server directory with 33,000+ servers.

Features

  • An MCP (Model Context Protocol) server that provides Ethereu

Use Cases

Check Ethereum balances and transaction history for wallet monitoring.
Track ERC20 token transfers and contract interactions.
Monitor gas prices and blockchain activity in real-time.
crazyrabbitLTC

Maintainer

LicenseMIT License
Languagetypescript
Versionv1.0.0
UpdatedApr 30, 2026
Statushealthy
Maintenanceactive

Works with

ClaudeOpenAIwindowsmacoslinux
View SourceBrowse All Servers

Installation

Manual Installation

npx mcp-etherscan-server

Configuration

Configuration Details

Config File

claude_desktop_config.json

Performance

Response Metrics

Response Time< 200ms
ThroughputMedium

Resource Usage

Memory UsageLow
CPU UsageLow

How to Set Up and Use Etherscan

The MCP Etherscan Server connects Claude to Ethereum blockchain data through Etherscan's API, enabling wallet balance lookups, transaction history retrieval, ERC20 token transfer tracking, smart contract ABI fetching, real-time gas price monitoring, and ENS name resolution. It operates over stdio for straightforward integration with any MCP-compatible client. Ethereum developers, DeFi analysts, and wallet operators can use it to inspect on-chain data through natural language without writing custom Etherscan queries.

Prerequisites

  • Node.js 18 or higher installed
  • A free or paid Etherscan API key from etherscan.io/apis
  • An MCP-compatible client such as Claude Desktop
1

Clone and install the server

Clone the repository and install all Node.js dependencies.

git clone https://github.com/crazyrabbitLTC/mcp-etherscan-server.git
cd mcp-etherscan-server
npm install
2

Build the TypeScript source

Compile the TypeScript source files into JavaScript.

npm run build
3

Create a .env file with your API key

Create a .env file in the project root with your Etherscan API key.

echo "ETHERSCAN_API_KEY=your_etherscan_api_key_here" > .env
4

Test the server

Start the server directly to verify it runs without errors.

npm start
5

Configure Claude Desktop

Add the server to your Claude Desktop config file with your Etherscan API key in the environment.

{
  "mcpServers": {
    "etherscan": {
      "command": "node",
      "args": ["/path/to/mcp-etherscan-server/dist/index.js"],
      "env": {
        "ETHERSCAN_API_KEY": "your_etherscan_api_key_here"
      }
    }
  }
}

Etherscan Examples

Client configuration

Claude Desktop configuration for the MCP Etherscan Server with an Etherscan API key.

{
  "mcpServers": {
    "etherscan": {
      "command": "node",
      "args": ["/path/to/mcp-etherscan-server/dist/index.js"],
      "env": {
        "ETHERSCAN_API_KEY": "YourEtherscanApiKeyHere"
      }
    }
  }
}

Prompts to try

Example prompts for checking balances, transactions, tokens, gas, and ENS names.

- "Check the ETH balance of 0x742d35Cc6634C0532925a3b844Bc454e4438f44e"
- "Show me the recent transactions for vitalik.eth"
- "What ERC20 token transfers have occurred from 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045 in the last 100 blocks?"
- "Fetch the contract ABI for the USDC token at 0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48"
- "What are the current Ethereum gas prices — safe low, standard, and fast?"

Troubleshooting Etherscan

All API calls return 'NOTOK' or 'Invalid API Key'

Verify your ETHERSCAN_API_KEY is correct and set in the env block of your MCP config. Free Etherscan API keys are rate-limited to 5 calls/second — if you need higher throughput, upgrade to a paid Etherscan plan.

ENS name resolution returns null or not found

ENS resolution requires the address to have a reverse record set on-chain. Not all addresses have ENS names. Try passing the raw 0x address directly if you only need to look up an address rather than resolve a name.

npm run build fails with TypeScript errors

Ensure Node.js 18+ is installed. Delete node_modules and package-lock.json, then run 'npm install' again. If TypeScript itself is missing, run 'npm install -g typescript' and retry the build.

Frequently Asked Questions about Etherscan

What is Etherscan?

Etherscan is a Model Context Protocol (MCP) server that 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 It connects AI assistants to external tools and data sources through a standardized interface.

How do I install Etherscan?

Follow the installation instructions on the Etherscan GitHub repository. Clone the repo, install dependencies, and add the server config to your AI client.

Which AI clients work with Etherscan?

Etherscan works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.

Is Etherscan free to use?

Yes, Etherscan is open source and available under the MIT License license. You can use it freely in both personal and commercial projects.

Learn More About MCP Servers

Getting Started with MCP

Set up your first MCP server in minutes

MCP Setup Guide

Configure MCP in Claude, Cursor & VS Code

All MCP Tutorials

18+ hands-on guides for developers

MCP FAQ

40+ answers about Model Context Protocol

Etherscan Alternatives — Similar Finance & Fintech Servers

Looking for alternatives to Etherscan? Here are other popular finance & fintech servers you can use with Claude, Cursor, and VS Code.

ValueCell

★ 10.7k

ValueCell is a community-driven, multi-agent platform for financial applications.

Vibe Trading

★ 8.1k

'Vibe-Trading: Your Personal Trading Agent'

Quantdinger

★ 6.2k

AI quantitative trading platform for crypto, stocks, and forex with backtesting, live trading, market data, and multi-agent research.vibe-trading ,trading-agents,ai-trader,ai-trading

TradingView

★ 2.8k

Real-time crypto & stock screening, advanced technical indicators, Bollinger Bands intelligence, candlestick patterns + native Claude Desktop integration. Multi-exchange (Binance, KuCoin, Bybit+). Open-source AI trading infrastructure.

Financial Datasets

★ 2.1k

Provides access to comprehensive financial data including income statements, balance sheets, cash flow statements, stock prices, company news, SEC filings, and cryptocurrency information with built-in financial ratio analysis.

Stripe

★ 1.6k

The Stripe Model Context Protocol server allows you to integrate with Stripe APIs through function calling. This protocol supports various tools to interact with different Stripe services.

Browse More Finance & Fintech MCP Servers

Explore all finance & fintech servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.

Finance & FintechBrowse All Servers

Quick Config Preview

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

Add this to your claude_desktop_config.json or .cursor/mcp.json

Read the full setup guide →

Ready to use Etherscan?

Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.

33,000+ ServersFree & Open SourceStep-by-Step Guides
Explore All ServersRead Our Guides