1scan - Blockchain Explorer API Gateway & MCP Server
About
A unified API gateway for integrating multiple etherscan-like blockchain explorer APIs with Model Context Protocol (MCP) support for AI assistants.
Details
- Author
- huahuayu
- GitHub stars
- 9
- Downloads
- 305
- Categories
- Developer Tools
Jump to
- Unified endpoint for 27+ EVM blockchain explorers
- API load balancing across multiple keys per network
- Rate limit management for each API key
- Custom API key support via URL parameters
- MCP server exposing 20+ blockchain data tools to AI models
Setting up with Highlight
This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:
- Download and install Highlight from highlightai.com/download
- Navigate to the plugins tab and select "Add Custom Plugin"
-
Configure the plugin with the settings below
Plugin Name
1scan - Blockchain Explorer API Gateway & MCP ServerCommand (node, npx, python, etc.)Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
- Enable "Start Automatically" if you want the plugin to start when Highlight launches
From the repository
Install via go install github.com/huahuayu/1scan@latest or build from source. Create a config.json with your API keys and rate limits per chain (e.g., for Ethereum chain ID 1). Run the API server with 1scan -config config.json and the MCP server with 1scanmcp -config config.json. In Cursor IDE, add an MCP server with the URL http://localhost:3000/mcp/sse. Customize MCP parameters (-port, -path, -transport for SSE or stdio).
Claude Desktop / Cursor
Paste into your MCP client config file to install this server.
{
"mcpServers": {
"1scan - blockchain explorer api gateway & mcp server": {
"1scan": {
"url": "http://localhost:3000/mcp/sse",
"command": "1scanmcp"
}
}
}
}McpServers
{
"1scan": {
"url": "http://localhost:3000/mcp/sse",
"command": "1scanmcp"
}
}1scan - Blockchain Explorer API Gateway & MCP Server
A unified API gateway for integrating multiple etherscan-like blockchain explorer APIs with Model Context Protocol (MCP) support for AI assistants.
Overview
1scan provides two main components:
1. API Gateway: A unified endpoint for accessing multiple blockchain explorer APIs
2. MCP Server: Allows AI models (like Claude in Cursor IDE) to directly query blockchain data
Supported Blockchain Networks
Apply for your own API key from the corresponding blockchain explorer
| Network Name | Chain ID | Explorer Link | Explorer API Endpoint |
| ------------------- | -------- | ------------------------------- | ------------------------------------ |
| Ethereum | 1 | https://etherscan.io | api.etherscan.io |
| Binance Smart Chain | 56 | https://bscscan.com | api.bscscan.com |
| Arbitrum One | 42161 | https://arbiscan.io | api.arbiscan.io |
| Polygon | 137 | https://polygonscan.com | api.polygonscan.com |
| Optimism | 10 | https://optimistic.etherscan.io | api-optimistic.etherscan.io |
| Avalanche C-Chain | 43114 | https://snowtrace.io | api.snowtrace.io |
| Base | 8453 | https://basescan.org | api.basescan.org |
| zkSync Era | 324 | https://explorer.zksync.io | block-explorer-api.mainnet.zksync.io |
| Gnosis | 100 | https://gnosisscan.io | api.gnosisscan.io |
| Fantom | 250 | https://ftmscan.com | api.ftmscan.com |
| Mantle | 5000 | https://mantlescan.info | api.mantlescan.info |
| Cronos | 25 | https://cronoscan.com | api.cronoscan.com |
| Polygon ZkEVM | 1101 | https://zkevm.polygonscan.com | api-zkevm.polygonscan.com |
| Linea | 59144 | https://lineascan.build | api.lineascan.build |
| Moonbeam | 1284 | https://moonscan.io | api.moonscan.io |
| Celo | 42220 | https://celoscan.io | api.celoscan.io |
| Scroll | 534352 | https://scrollscan.com | api.scrollscan.com |
| OpBNB | 204 | https://opbnbscan.com | api.opbnbscan.com |
| Moonriver | 1285 | https://moonriver.moonscan.io | api-moonriver.moonscan.io |
| Arbitrum Nova | 42170 | https://nova.arbiscan.io | api-nova.arbiscan.io |
| Blast | 81457 | https://blastscan.io | api.blastscan.io |
| Fraxtal | 252 | https://fraxscan.com | api.fraxscan.com |
| Wemix | 1111 | https://wemixscan.com | api.wemixscan.com |
| Xai | 660279 | https://xaiscan.io | api.xaiscan.io |
| World Chain | 480 | https://worldscan.org | api.worldscan.org |
| Ape | 33139 | https://apescan.io/ | api.apescan.io |
| Kroma | 255 | https://kromascan.com | api.kromascan.com |
| Taiko | 167000 | https://taikoscan.io | api.taikoscan.io |
| Bittorrent | 199 | https://bttcscan.com | api.bttcscan.com |
| Xdc | 50 | https://xdcscan.io | api.xdcscan.io |
Features
- 🔄 Unified API endpoint for multiple blockchain explorers
- ⚖️ API load balancing
- 🔑 API rate limit management
- 🎯 Custom API key support via URL parameters
- 🤖 MCP server for AI assistants to query blockchain data
Installation
From Go
go install github.com/huahuayu/1scan@latest
From Source
```bash
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
