Etherscan MCP Server logo

Etherscan MCP Server

by huahuayu

The Etherscan MCP Server is a Go implementation of an Etherscan API client for the Model Context Protocol (MCP). It enables LLM applications to access Etherscan blockchain data across 50+ chains using a single API key.

View on GitHub

Last updated: N/A

What is Etherscan MCP Server?

The Etherscan MCP Server is a Go-based server that acts as an interface between LLM applications and the Etherscan API. It allows LLMs to query and retrieve blockchain data from Etherscan using natural language queries, making it easier to integrate blockchain information into LLM-powered applications.

How to use Etherscan MCP Server?

  1. Clone the repository. 2. Set the Etherscan API key as an environment variable. 3. Build and install the server. 4. Run the server in either default (stdin/stdout) or SSE mode. 5. Configure your LLM application to communicate with the server using the appropriate MCP configuration.

Key features of Etherscan MCP Server

  • Access to Etherscan API V2 for multi-chain support

  • Single API key for over 50 supported chains

  • Support for various blockchain data retrieval methods (account balances, block information, contract data, gas oracle, token information, transaction data)

  • Integration with Model Context Protocol (MCP) for seamless LLM integration

Use cases of Etherscan MCP Server

  • Retrieving account balances for specific addresses

  • Fetching block information for analysis

  • Interacting with smart contracts using ABI and source code

  • Obtaining gas price information for transaction optimization

  • Tracking token transfers and ownership

FAQ from Etherscan MCP Server

What is an Etherscan API key and where do I get one?

An Etherscan API key is required to access the Etherscan API. You can obtain one for free at https://etherscan.io/myapikey.

What chains are supported by the Etherscan MCP Server?

The server supports over 50 chains. Please refer to https://docs.etherscan.io/etherscan-v2/getting-started/supported-chains for a complete list.

What is MCP and how does it relate to this server?

MCP stands for Model Context Protocol. This server implements the MCP to allow LLMs to access blockchain data through a standardized interface.

How do I run the server in SSE mode?

Run the server with the --sse flag: ./bin/etherscan-mcp-server --sse. You can also specify a port using --port <port>.

What kind of queries can I make to the server?

You can make natural language queries related to account balances, block information, contract data, gas prices, token information, and transaction data. Refer to the 'Example Queries' section in the README for examples.