Happy slice of mcp pizzaMCP.pizza
Fire in da houseTop Tip:Paying $100+ per month for Perplexity, MidJourney, Runway, ChatGPT and other tools is crazy - get all your AI tools in one site starting at $15 per month with Galaxy AI Fire in da houseCheck it out free

etherscan-mcp

MCP.Pizza Chef: xiaok

The etherscan-mcp is a Model Context Protocol server that provides real-time, structured access to Etherscan's blockchain data and API services. It enables LLMs and applications to query Ethereum blockchain information such as transactions, addresses, and contract details dynamically. This server facilitates seamless integration of blockchain context into AI workflows, supporting developers and users in building blockchain-aware applications and agents.

Use This MCP server To

Query Ethereum transaction details in real time Fetch wallet address balances and token holdings Retrieve smart contract source code and metadata Monitor blockchain events and transaction statuses Integrate blockchain data into AI-powered workflows Enable LLMs to answer Ethereum-related queries dynamically Support blockchain analytics and reporting tools Automate blockchain data extraction for audits

README

@xiaok/etherscan-mcp

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 server.js
npx fastmcp dev server.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 fastmcp inspect server.ts

FAQ

How to use with Claude Desktop?

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

{
  "mcpServers": {
    "my-mcp-server": {
      "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. fully test

etherscan-mcp FAQ

How do I test the etherscan-mcp server locally?
Use the command 'npx fastmcp dev server.js' or 'npx fastmcp dev server.ts' to run and debug the server with mcp-cli.
Can I inspect the etherscan-mcp server with a graphical interface?
Yes, you can use the official MCP Inspector tool by running 'npx fastmcp inspect server.ts' for a web UI inspection.
How do I configure etherscan-mcp with Claude Desktop?
Follow the MCP quickstart guide and add the provided JSON configuration snippet to integrate with Claude Desktop.
What blockchain data can etherscan-mcp provide?
It provides Ethereum blockchain data including transactions, wallet balances, token holdings, smart contract details, and event statuses.
Is etherscan-mcp limited to Ethereum mainnet data?
It primarily supports Ethereum mainnet data via Etherscan API but can be extended if Etherscan supports other networks.
Does etherscan-mcp support real-time blockchain event monitoring?
Yes, it can monitor transaction statuses and blockchain events dynamically through Etherscan's API.
What LLM providers can work with etherscan-mcp?
It is compatible with OpenAI, Anthropic Claude, and Google Gemini models via the MCP protocol.
How secure is the etherscan-mcp server?
It follows MCP's principles for secure, scoped, and observable model interactions, ensuring safe access to blockchain data.