An MCP server that gives AI agents fast access to verified EVM chain information, including RPC URLs, chain IDs, explorers, and native tokens.
Documentation
Chainlist MCP Server
An MCP server that gives AI agents fast access to verified EVM chain information, including RPC URLs, chain IDs, explorers, and native tokens — sourced from Chainlist.org.
Features
- Efficient Data Fetching: Caches Chainlist API data to minimize requests.
- Flexible Search: Case-insensitive keyword matching using regex for
getChainsByKeyword. - Structured Output: Markdown responses with tabulated
rpcandexplorersfor readability.
Installation
Prerequisites
- Python: Version 3.10 or higher.
- uv: Recommended for managing Python projects and dependencies (install via
pip install uvor follow uv documentation).
Steps
1. Clone the Repository:
git clone https://github.com/kukapay/chainlist-mcp.git
cd chainlist-mcp2. Install Dependencies:
uv sync3. Installing to Claude Desktop:
Install the server as a Claude Desktop application:
uv run mcp install cli.py --name "Chainlist MCP"Configuration file as a reference:
{
"mcpServers": {
"Chainlist MCP": {
"command": "uv",
"args": [ "--directory", "/path/to/chainlist-mcp", "run", "main.py" ]
}
}
} Replace /path/to/chainlist-mcp with your actual installation path.
Usage
The server exposes two tools via the MCP protocol, accessible through MCP-compatible clients or the MCP Inspector.
Tools
getChainById
- Description: Retrieves details of a blockchain by its chain ID.
- Parameters:
chain_id(integer): The unique identifier of the blockchain (e.g., 1 for Ethereum Mainnet).- Returns: A Markdown string with chain details or an error message.
Example Prompt (in an MCP client):
Get the details for the blockchain with chain ID 1.Example Response:
**Chain Details**
- **Name**: Ethereum Mainnet
- **Chain ID**: 1
- **Native Currency**: Ether (ETH, 18 decimals)
- **TVL**: 134376951329.85631
**RPC Endpoints**:
| URL | Tracking |
|----------------------------------------------|----------|
| https://eth.llamarpc.com | none |
| https://go.getblock.io/... | none |
...
**Explorers**:
| Name | URL | Standard |
|------------|----------------------------|----------|
| etherscan | https://etherscan.io | EIP3091 |
...getChainsByKeyword
- Description: Searches for blockchains by keyword (case-insensitive partial match).
- Parameters:
keyword(string): The keyword or partial name to search (e.g., 'eth').limit(integer, optional): Maximum number of results (default: 5).- Returns: A Markdown string listing up to
limitmatching chains or an error message.
Example Prompt (in an MCP client):
Find blockchains with 'eth' in their name, limit to 2 results.Example Response:
**Matching Chains**
### Chain 1
**Chain Details**
- **Name**: Ethereum Mainnet
- **Chain ID**: 1
- **Native Currency**: Ether (ETH, 18 decimals)
- **TVL**: 134376951329.85631
**RPC Endpoints**:
| URL | Tracking |
|----------------------------------------------|----------|
| https://eth.llamarpc.com | none |
...
**Explorers**:
| Name | URL | Standard |
|------------|----------------------------|----------|
| etherscan | https://etherscan.io | EIP3091 |
...
### Chain 2
**Chain Details**
- **Name**: Ethereum Goerli
- **Chain ID**: 5
- **Native Currency**: Ether (ETH, 18 decimals)
- **TVL**: N/A
**RPC Endpoints**:
| URL | Tracking |
|----------------------------------------------|----------|
| https://goerli.infura.io/... | yes |
...
**Explorers**:
| Name | URL | Standard |
|------------|----------------------------|----------|
| etherscan | https://goerli.etherscan.io | EIP3091 |
...License
This project is licensed under the MIT License. See the LICENSE file for details.
Similar MCP
Based on tags & features
Trending MCP
Most active this week