mcpField
@
@xiaok/etherscan-mcp

@xiaok/etherscan-mcp

Local
github.com/xiaokFinance18Updated 59w ago
Repository

About @xiaok/etherscan-mcp

@xiaok/etherscan-mcp is an MCP server for interacting with Etherscan APIs and services. Its README documents testing and inspection options and an ETHERSCAN_API_KEY configuration example.

Key features

  1. 01Etherscan API interaction
  2. 02Terminal testing with fastmcp dev
  3. 03Web UI inspection with MCP Inspector
  4. 04API key environment configuration

Use cases

  1. 01Connect an MCP client to Etherscan services
  2. 02Test or debug the server from a terminal
  3. 03Inspect the server through a web UI

MCP support

Provides an MCP server that connects clients to Etherscan APIs and services. The README shows Claude Desktop configuration using ETHERSCAN_API_KEY.

Configuration

Local server config is the same for every client. Copy it into your client’s MCP config file.

mcp.json · Universal config
{
  "mcpServers": {
    "etherscan": {
      "command": "npx",
      "args": [
        "-y",
        "fastmcp"
      ]
    }
  }
}
Run commandnpx -y fastmcp

Local servers need a runtime on your machine (e.g. Node.js 18+). Config file locations differ by client; see your client’s docs.

Packages
npmfastmcp

Tools

No tool list yet

Local servers expose tools only once running on your machine, and the maintainer has not provided a tool list.

Details

From the project 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

Comments

Markdown supported

New to MCP?

From what the protocol is to installing your first server, these answers cover most first questions.

An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.