etherscan-mcp

This project is a dynamic MCP server for interacting with Etherscan's API and services. Built in TypeScript, it provides tools for developers to easily test and debug their server. It also allows inspection of the server using the MCP Inspector with a web UI.

GitHub Stars

10

User Rating

Not Rated

Favorites

0

Views

33

Forks

4

Issues

1

README
@xiaok/etherscan-mcp

smithery badge

A dynamic MCP server for interacting with Etherscan's API and services.

Etherscan MCP server
Running Your Server
Test with mcp-cli

The fastest way to test and debug your server is with fastmcp dev:

npx fastmcp dev src/index.ts

This will run your server with mcp-cli for testing and debugging your MCP server in the terminal.

Inspect with MCP Inspector

Another way is to use the official MCP Inspector to inspect your server with a Web UI:

npx npx fastmcp inspect src/index.ts
FAQ
How to use with Claude Desktop?

Follow the guide https://modelcontextprotocol.io/quickstart/user and add the following configuration:

{
  "mcpServers": {
    "etherscan_mcp": {
      "command": "npx",
      "args": ["tsx", "/PATH/TO/YOUR_PROJECT/src/index.ts"],
      "env": {
        "ETHERSCAN_API_KEY": "********"
      }
    }
  }
}
API Doc

https://docs.etherscan.io/etherscan-v2

support chain list: https://docs.etherscan.io/etherscan-v2/getting-started/supported-chains

Please note that not all endpoints are supported by all chains. Please find support list here: https://forms.blockscan.com/public/grid/3E9QiN00NLhCQVibiP3Z-Bpqhmd7zGXsgapEKJupxiI

TODO
  1. support pro api