trackmcp
Back to directory
xiaok

etherscan-mcp

View on GitHub

Model Context Protocol (MCP) Server for Etherscan

16 stars TypeScriptAI & Machine Learning Updated Nov 2, 2025

Documentation

@xiaok/etherscan-mcp

smithery badge

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

Running Your Server

Test with `mcp-cli`

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

bash
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:

bash
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:

json
{
  "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

Frequently asked questions

What is etherscan-mcp?

etherscan-mcp is Model Context Protocol (MCP) Server for Etherscan

How do I install etherscan-mcp?

Open the GitHub repository and follow its README. Most MCP servers are added to your client's MCP config, then called by your agent.

Is etherscan-mcp open source?

Yes — it is hosted on GitHub at https://github.com/xiaok/etherscan-mcp and has 16 stars.

Related MCP tools

Run your own MCP server? See who uses it and what to fix.

Measure it with TrackMCP