1scan - Blockchain Explorer API Gateway & MCP Server

by huahuayu

9 305 downloads Not rated yet

GitHub

Developer Tools

About

A unified API gateway for integrating multiple etherscan-like blockchain explorer APIs with Model Context Protocol (MCP) support for AI assistants.

Explore

- 🔄 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

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 Server

Command (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

Setting up with Cursor

Open Cursor's settings
Navigate to the MCP section
Click "Add new Global MCP server"
Copy and paste the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "1scan - blockchain explorer api gateway & mcp server": {
            "1scan": {
                "url": "http://localhost:3000/mcp/sse",
                "command": "1scanmcp"
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "1scan - blockchain explorer api gateway & mcp server": {
            "1scan": {
                "url": "http://localhost:3000/mcp/sse",
                "command": "1scanmcp"
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "1scan - blockchain explorer api gateway & mcp server": {
            "1scan": {
                "url": "http://localhost:3000/mcp/sse",
                "command": "1scanmcp"
            }
        }
    }
}

Setting up with Claude Desktop

Open Claude Desktop's settings
Go to the Integrations tab
Click "Add MCP Server"
Use the configuration below based on your operating system

Note: Make sure Claude Desktop is running before attempting to connect.

JSON

{
    "mcpServers": {
        "1scan - blockchain explorer api gateway & mcp server": {
            "1scan": {
                "url": "http://localhost:3000/mcp/sse",
                "command": "1scanmcp"
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "1scan - blockchain explorer api gateway & mcp server": {
            "1scan": {
                "url": "http://localhost:3000/mcp/sse",
                "command": "1scanmcp"
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "1scan - blockchain explorer api gateway & mcp server": {
            "1scan": {
                "url": "http://localhost:3000/mcp/sse",
                "command": "1scanmcp"
            }
        }
    }
}

Setting up with Windsurf

Open Windsurf's preferences
Go to the Integrations section
Click "Add MCP Integration"
Use the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "1scan - blockchain explorer api gateway & mcp server": {
            "1scan": {
                "url": "http://localhost:3000/mcp/sse",
                "command": "1scanmcp"
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "1scan - blockchain explorer api gateway & mcp server": {
            "1scan": {
                "url": "http://localhost:3000/mcp/sse",
                "command": "1scanmcp"
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "1scan - blockchain explorer api gateway & mcp server": {
            "1scan": {
                "url": "http://localhost:3000/mcp/sse",
                "command": "1scanmcp"
            }
        }
    }
}

Setting up with Cline

Open Cline's settings
Navigate to the Integrations section
Click "Add MCP Server"
Copy and paste the configuration below based on your operating system

Note: Make sure to restart Cline after adding the configuration.

JSON

{
    "mcpServers": {
        "1scan - blockchain explorer api gateway & mcp server": {
            "1scan": {
                "url": "http://localhost:3000/mcp/sse",
                "command": "1scanmcp"
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "1scan - blockchain explorer api gateway & mcp server": {
            "1scan": {
                "url": "http://localhost:3000/mcp/sse",
                "command": "1scanmcp"
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "1scan - blockchain explorer api gateway & mcp server": {
            "1scan": {
                "url": "http://localhost:3000/mcp/sse",
                "command": "1scanmcp"
            }
        }
    }
}

Setting up with Goose

Open Goose's preferences
Go to the Integrations tab
Select "MCP Servers"
Click "Add New Server"
Use the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "1scan - blockchain explorer api gateway & mcp server": {
            "1scan": {
                "url": "http://localhost:3000/mcp/sse",
                "command": "1scanmcp"
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "1scan - blockchain explorer api gateway & mcp server": {
            "1scan": {
                "url": "http://localhost:3000/mcp/sse",
                "command": "1scanmcp"
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "1scan - blockchain explorer api gateway & mcp server": {
            "1scan": {
                "url": "http://localhost:3000/mcp/sse",
                "command": "1scanmcp"
            }
        }
    }
}

From the repository

Create a config.json file with your API keys:

{
  "1": {
    "endpoint": "api.etherscan.io",
    "keys": {
      "YOUR_ETHERSCAN_API_KEY_1": 5,
      "YOUR_ETHERSCAN_API_KEY_2": 10
    }
  },
  "56": {
    "endpoint": "api.bscscan.com",
    "keys": {
      "YOUR_BSCSCAN_API_KEY": 5
    }
  }
}

Each chain entry contains:

- chainID: The blockchain network ID
- endpoint: The API endpoint for the blockchain explorer
- keys: Map of API keys and their rate limits (requests per second)

When running the MCP server, you can customize it with these parameters:

- -port: Port to run the MCP server on (default: "3000")
- -path: Path for the MCP server endpoint (default: "/mcp")
- -config: Path to configuration file (default: "config.json")
- -transport: Transport type (sse or stdio) (default: "sse")

Example:

1scanmcp -port 3000 -config /path/to/config.json

ps aux | grep 1scanmcp
```

2. Ensure the correct URL is configured in Cursor

`getAccountBalance`

Get the balance of an account on a specific blockchain

`getTokenBalance`

Get the token balance of an account on a specific blockchain

`getTransactionByHash`

Get transaction details by hash

`getBlockByNumber`

Get block information by block number

`getContractABI`

Get the ABI for a verified contract

`getContractSourceCode`

Get the source code of a verified contract

`getTokenInfo`

Get information about an ERC20 token

`getGasPrice`

Get current gas price on a specific blockchain

`getLogs`

Get event logs matching specified parameters

`getTransaction`

Get details of a transaction by its hash

`getTransactionCount`

Get the number of transactions sent from an address

`getTransactionReceipt`

Get transaction receipt by transaction hash

`getBlockTransactionCountByNumber`

Get the number of transactions in a block

`getBlockTransactionCountByHash`

Get the number of transactions in a block by block hash

`getBlockByHash`

Get information about a block by its hash

`getNormalTransactions`

Get normal transactions by address

`getInternalTransactions`

Get internal transactions by address or transaction hash

`getERC20Transfers`

Get ERC-20 token transfer events by address or contract

`getERC721Transfers`

Get ERC-721 NFT transfer events by address or contract

`getValidators`

Get validator information (for networks with validator sets)

`getContractCreation`

Get contract creation information

`getContractVerificationStatus`

Check contract verification status

The MCP server exposes these tools to AI models:

- getAccountBalance - Get the balance of an account on a specific blockchain
- getTokenBalance - Get the token balance of an account on a specific blockchain
- getTransactionByHash - Get transaction details by hash
- getBlockByNumber - Get block information by block number
- getContractABI - Get the ABI for a verified contract
- getContractSourceCode - Get the source code of a verified contract
- getTokenInfo - Get information about an ERC20 token
- getGasPrice - Get current gas price on a specific blockchain
- getLogs - Get event logs matching specified parameters
- getTransaction - Get details of a transaction by its hash
- getTransactionCount - Get the number of transactions sent from an address
- getTransactionReceipt - Get transaction receipt by transaction hash
- getBlockTransactionCountByNumber - Get the number of transactions in a block
- getBlockTransactionCountByHash - Get the number of transactions in a block by block hash
- getBlockByHash - Get information about a block by its hash
- getNormalTransactions - Get normal transactions by address
- getInternalTransactions - Get internal transactions by address or transaction hash
- getERC20Transfers - Get ERC-20 token transfer events by address or contract
- getERC721Transfers - Get ERC-721 NFT transfer events by address or contract
- getValidators - Get validator information (for networks with validator sets)
- getContractCreation - Get contract creation information
- getContractVerificationStatus - Check contract verification status

The MCP server exposes these tools to AI models:

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"
    }
}

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 | ------------------- | Ethereum | 1 | Binance Smart Chain | 56 | Arbitrum One | Polygon | 137 | Optimism | 10 | Avalanche C-Chain | 43114 | Base | 8453 | zkSync Era | 324 | Gnosis | 100 | Fantom | 250 | Mantle | 5000 | Cronos | 25 | Polygon ZkEVM | 1101 | Linea | Moonbeam | 1284 | Celo | Scroll | OpBNB | 204 | Moonriver | 1285 | Arbitrum Nova | Blast | Fraxtal | 252 | Wemix | 1111 | Xai | World Chain | 480 | Ape | Kroma | 255 | Taiko | Bittorrent | 199 | Xdc | 50 | Chain ID | Explorer Link | Explorer API Endpoint |
| -------- | ------------------------------- | ------------------------------------ |
| https://etherscan.io | api.etherscan.io |
| https://bscscan.com | api.bscscan.com |
| 42161 | https://arbiscan.io | api.arbiscan.io |
| https://polygonscan.com | api.polygonscan.com |
| https://optimistic.etherscan.io | api-optimistic.etherscan.io |
| https://snowtrace.io | api.snowtrace.io |
| https://basescan.org | api.basescan.org |
| https://explorer.zksync.io | block-explorer-api.mainnet.zksync.io |
| https://gnosisscan.io | api.gnosisscan.io |
| https://ftmscan.com | api.ftmscan.com |
| https://mantlescan.info | api.mantlescan.info |
| https://cronoscan.com | api.cronoscan.com |
| https://zkevm.polygonscan.com | api-zkevm.polygonscan.com |
| 59144 | https://lineascan.build | api.lineascan.build |
| https://moonscan.io | api.moonscan.io |
| 42220 | https://celoscan.io | api.celoscan.io |
| 534352 | https://scrollscan.com | api.scrollscan.com |
| https://opbnbscan.com | api.opbnbscan.com |
| https://moonriver.moonscan.io | api-moonriver.moonscan.io |
| 42170 | https://nova.arbiscan.io | api-nova.arbiscan.io |
| 81457 | https://blastscan.io | api.blastscan.io |
| https://fraxscan.com | api.fraxscan.com |
| https://wemixscan.com | api.wemixscan.com |
| 660279 | https://xaiscan.io | api.xaiscan.io |
| https://worldscan.org | api.worldscan.org |
| 33139 | https://apescan.io/ | api.apescan.io |
| https://kromascan.com | api.kromascan.com |
| 167000 | https://taikoscan.io | api.taikoscan.io |
| https://bttcscan.com | api.bttcscan.com |
| https://xdcscan.io | api.xdcscan.io |

Features

Installation

From Go

go install github.com/huahuayu/1scan@latest

From Source

```bash

No reviews yet — be the first

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.

About

Explore

Setting up with Highlight

From the repository

getAccountBalance

getTokenBalance

getTransactionByHash

getBlockByNumber

getContractABI

getContractSourceCode

getTokenInfo

getGasPrice

getLogs

getTransaction

getTransactionCount

getTransactionReceipt

getBlockTransactionCountByNumber

getBlockTransactionCountByHash

getBlockByHash

getNormalTransactions

getInternalTransactions

getERC20Transfers

getERC721Transfers

getValidators

getContractCreation

getContractVerificationStatus

Claude Desktop / Cursor

McpServers

Overview

Supported Blockchain Networks

Features

Installation

From Go

From Source

More like this

Sentry

Github

Git

GitLab

`getAccountBalance`

`getTokenBalance`

`getTransactionByHash`

`getBlockByNumber`

`getContractABI`

`getContractSourceCode`

`getTokenInfo`

`getGasPrice`

`getLogs`

`getTransaction`

`getTransactionCount`

`getTransactionReceipt`

`getBlockTransactionCountByNumber`

`getBlockTransactionCountByHash`

`getBlockByHash`

`getNormalTransactions`

`getInternalTransactions`

`getERC20Transfers`

`getERC721Transfers`

`getValidators`

`getContractCreation`

`getContractVerificationStatus`