mirror of
https://github.com/alibaba/higress.git
synced 2026-04-22 12:37:26 +08:00
89 lines
4.1 KiB
Markdown
89 lines
4.1 KiB
Markdown
# Blockscout MCP Server
|
||
|
||
Blockscout is an open-source blockchain explorer for inspecting and analyzing EVM-compatible blockchains. This MCP server for Blockscout wraps the official Blockscout multi-chain API, exposing blockchain data - balances, tokens, NFTs, contract metadata - via MCP so that AI agents and tools can access and analyze it contextually.
|
||
|
||
- [Blockscout Website](https://blockscout.com/)
|
||
- [MCP Server Plugin GitHub repo](https://github.com/blockscout/mcp-server-plugin)
|
||
|
||
## Features
|
||
|
||
Blockscout MCP Server provides the following features:
|
||
|
||
- **Chain Information**: Get a list of supported blockchains.
|
||
- **Address and Contract Analysis**: Resolve ENS names, get address balances, contract details, and retrieve contract ABIs.
|
||
- **Token and NFT Data**: Look up tokens by symbol, and get detailed information on token holdings and NFTs for a given address.
|
||
- **Transaction and Block History**: Retrieve information on blocks, get transaction history for an address, and get detailed information about specific transactions, including human-readable summaries.
|
||
- **Event Logs**: Get decoded event logs for transactions or addresses.
|
||
|
||
## Usage Guide
|
||
|
||
The Blockscout MCP Server is in Beta and currently does not require authentication. This is subject to change.
|
||
|
||
### Generate URL
|
||
|
||
Log in to the [Higress MCP Marketplace](https://mcp.higress.ai) and generate a URL for either Streamable HTTP or SSE.
|
||
|
||
### Configure MCP Client
|
||
|
||
In your MCP Client configuration, add the following to the MCP Server list:
|
||
|
||
```json
|
||
"mcpServers": {
|
||
"mcp-blockscout": {
|
||
"url": "https://mcp.higress.ai/mcp-blockscout/{user-specific-id}/sse"
|
||
}
|
||
}
|
||
```
|
||
|
||
or in case of Streamable HTTP:
|
||
|
||
```json
|
||
"mcpServers": {
|
||
"mcp-blockscout": {
|
||
"url": "https://mcp.higress.ai/mcp-blockscout/{user-specific-id}"
|
||
}
|
||
}
|
||
```
|
||
|
||
## Supported Tools
|
||
|
||
The following tools are available in the multi-chain configuration.
|
||
|
||
1. `__get_instructions__()` - Must be called before any other tool. Initializes the MCP server session.
|
||
2. `get_chains_list()` - Gets the list of supported blockchain chains and their IDs.
|
||
3. `get_address_by_ens_name(name)` - Converts an ENS domain name to its corresponding Ethereum address.
|
||
4. `lookup_token_by_symbol(chain_id, symbol)` - Searches for token addresses by symbol or name.
|
||
5. `get_contract_abi(chain_id, address)` - Retrieves the ABI (Application Binary Interface) for a smart contract.
|
||
6. `get_address_info(chain_id, address)` - Gets comprehensive information about an address (balance, contract status, etc.).
|
||
7. `get_tokens_by_address(chain_id, address)` - Returns detailed ERC20 token holdings for an address.
|
||
8. `get_latest_block(chain_id)` - Returns the latest indexed block number and timestamp.
|
||
9. `get_transactions_by_address(chain_id, address, age_from, age_to, methods)` - Gets native currency transfers and smart contract interactions for an address.
|
||
10. `get_token_transfers_by_address(chain_id, address, age_from, age_to, token)` - Returns ERC-20 token transfers for an address.
|
||
11. `transaction_summary(chain_id, transaction_hash)` - Provides a human-readable summary of a transaction.
|
||
12. `nft_tokens_by_address(chain_id, address)` - Retrieves NFT tokens owned by an address.
|
||
13. `get_block_info(chain_id, number_or_hash)` - Returns block information (timestamp, gas used, etc.).
|
||
14. `get_transaction_info(chain_id, transaction_hash)` - Gets comprehensive transaction information.
|
||
15. `get_transaction_logs(chain_id, transaction_hash)` - Returns transaction logs with decoded event data.
|
||
16. `get_address_logs(chain_id, address)` - Gets logs emitted by a specific address with decoded event data.
|
||
|
||
## Example Prompts
|
||
|
||
```plaintext
|
||
On which popular networks is `ens.eth` deployed as a contract?
|
||
```
|
||
|
||
```plaintext
|
||
What are the usual activities performed by `ens.eth` on the Ethereum Mainnet?
|
||
Since it is a contract, what is the most used functionality of this contract?
|
||
Which address interacts with the contract the most?
|
||
```
|
||
|
||
```plaintext
|
||
Calculate the total gas fees paid on Ethereum by address `0xcafe...cafe` in May 2025.
|
||
```
|
||
|
||
```plaintext
|
||
Which 10 most recent logs were emitted by `0xFe89cc7aBB2C4183683ab71653C4cdc9B02D44b7`
|
||
before `Nov 08 2024 04:21:35 AM (-06:00 UTC)`?
|
||
```
|