eth-mcp-server

What is eth-mcp-server?

A Model Context Protocol (MCP) server that provides Ethereum blockchain capabilities to AI assistants, such as checking balances, gas prices, and transaction details. It is currently experimental and built for fun.

How to use eth-mcp-server?

Install dependencies (Python 3.7+, web3.py, requests, mcp), replace the Etherscan API key in the source code, then configure the server as a stdio MCP server (e.g., in Cursor) pointing to the blockchain.py script. Tools are invoked via an AI assistant through MCP.

Key features of eth-mcp-server

• Get ETH balance for any Ethereum address
• Check current Ethereum price in USD
• Get current gas prices on the Ethereum network
• Retrieve latest block information
• View transaction details and estimate fees
• Query account transaction history
• Exposes Ethereum data as MCP resources (ethereum:// URIs)

Use cases of eth-mcp-server

• AI assistants fetching real-time Ethereum price or gas data
• Checking the balance of a given Ethereum address
• Retrieving transaction details or account history
• Estimating transaction fees for a given gas amount
• Integrating blockchain queries into chat‑based development tools

FAQ from eth-mcp-server

What Python version is required?

Python 3.7 or higher is required.

Do I need an API key to use this server?

Yes, you must replace the placeholder ETHERSCAN_API_KEY in the code with your own Etherscan API key.

Which external APIs does the server use?

It uses the Ethereum JSON‑RPC API via LlamaRPC, CoinGecko for ETH price, and Etherscan for transaction history.

How do I set up eth-mcp-server with Cursor?

In Cursor’s MCP settings, add a new global MCP server with type stdio, set the command to /path/to/python /path/to/blockchain.py, and click save.

What tools are available?

Seven tools: get_eth_balance, get_eth_price, get_gas_price, get_latest_block, get_transaction, estimate_tx_fee, and get_account_transactions.