https://github.com/xiaok/etherscan-mcp
Model Context Protocol (MCP) Server for Etherscan
https://github.com/xiaok/etherscan-mcp
Last synced: 3 months ago
JSON representation
Model Context Protocol (MCP) Server for Etherscan
- Host: GitHub
- URL: https://github.com/xiaok/etherscan-mcp
- Owner: xiaok
- License: mit
- Created: 2025-04-28T06:20:49.000Z (7 months ago)
- Default Branch: main
- Last Pushed: 2025-06-20T08:53:03.000Z (5 months ago)
- Last Synced: 2025-06-20T09:40:01.661Z (5 months ago)
- Language: TypeScript
- Size: 53.7 KB
- Stars: 9
- Watchers: 1
- Forks: 3
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- awesome-mcp-servers - **xiaok/etherscan-mcp** - Facilitates seamless interaction with Etherscan's API through a dynamic MCP server. `api` `http` `ml` `git` `github` (🤖 AI/ML)
- awesome-mcp-servers - xiaok/etherscan-mcp
- toolsdk-mcp-registry - ✅ etherscan-mcp
- metorial-index - Etherscan API Integration Server - Interact with Etherscan's API for accessing blockchain data, enabling dynamic querying and retrieval of information from multiple blockchain networks through a standardized interface. Supports testing and debugging with command line tools and web UI inspection. (Blockchain and Crypto)
README
# @xiaok/etherscan-mcp
[](https://smithery.ai/server/@xiaok/etherscan-mcp-server)
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`](https://github.com/wong2/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`](https://modelcontextprotocol.io/docs/tools/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