What is Chainlist Mcp

Chainlist-mcp is an MCP server that provides AI agents with quick access to verified EVM chain information, including RPC URLs, chain IDs, explorers, and native tokens sourced from Chainlist.org.

Use cases

Use cases for chainlist-mcp include retrieving blockchain details for dApps, integrating EVM chain data into AI applications, and providing developers with quick access to necessary chain information.

How to use

To use chainlist-mcp, clone the repository from GitHub, install the required dependencies using ‘uv’, and run the server. It exposes tools like ‘getChainById’ for retrieving blockchain details via MCP-compatible clients.

Key features

Key features include efficient data fetching with caching, flexible search capabilities using case-insensitive regex, and structured output in Markdown format for better readability.

Where to use

Chainlist-mcp can be used in various fields such as blockchain development, decentralized application (dApp) creation, and any project requiring access to EVM chain information.

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 rpc and explorers for readability.

Installation

Prerequisites

• Python: Version 3.10 or higher.
• uv: Recommended for managing Python projects and dependencies (install via pip install uv or follow uv documentation).

Steps

1. Clone the Repository:

   git clone https://github.com/kukapay/chainlist-mcp.git
   cd chainlist-mcp
   

2. Install Dependencies:

   uv sync
   

3. 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 limit matching 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.