Chainlist MCP Server

1# Chainlist MCP Server
2 
3An 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.
4 
5![GitHub License](https://img.shields.io/github/license/kukapay/chainlist-mcp)
6![Python Version](https://img.shields.io/badge/python-3.10+-blue)
7![Status](https://img.shields.io/badge/status-active-brightgreen.svg)
8 
9## Features
10 
11- **Efficient Data Fetching**: Caches Chainlist API data to minimize requests.
12- **Flexible Search**: Case-insensitive keyword matching using regex for `getChainsByKeyword`.
13- **Structured Output**: Markdown responses with tabulated `rpc` and `explorers` for readability.
14 
15## Installation
16 
17### Prerequisites
18 
19- **Python**: Version 3.10 or higher.
20- **uv**: Recommended for managing Python projects and dependencies (install via `pip install uv` or follow [uv documentation](https://docs.astral.sh/uv/)).
21 
22### Steps
23 
241. **Clone the Repository**:
25   ```bash
26   git clone https://github.com/kukapay/chainlist-mcp.git
27   cd chainlist-mcp
28   ```
29 
302. **Install Dependencies**:
31   ```bash
32   uv sync
33   ```
34 
353. **Installing to Claude Desktop**:
36 
37    Install the server as a Claude Desktop application:
38    ```bash
39    uv run mcp install cli.py --name "Chainlist MCP"
40    ```
41 
42    Configuration file as a reference:
43 
44    ```json
45    {
46       "mcpServers": {
47           "Chainlist MCP": {
48               "command": "uv",
49               "args": [ "--directory", "/path/to/chainlist-mcp", "run", "main.py" ] 
50           }
51       }
52    }
53    ```
54    Replace `/path/to/chainlist-mcp` with your actual installation path.
55 
56## Usage
57 
58The server exposes two tools via the MCP protocol, accessible through MCP-compatible clients or the MCP Inspector.
59 
60### Tools
61 
62#### `getChainById`
63 
64- **Description**: Retrieves details of a blockchain by its chain ID.
65- **Parameters**:
66  - `chain_id` (integer): The unique identifier of the blockchain (e.g., 1 for Ethereum Mainnet).
67- **Returns**: A Markdown string with chain details or an error message.
68 
69**Example Prompt** (in an MCP client):
70```
71Get the details for the blockchain with chain ID 1.
72```
73 
74**Example Response**:
75```markdown
76**Chain Details**
77- **Name**: Ethereum Mainnet
78- **Chain ID**: 1
79- **Native Currency**: Ether (ETH, 18 decimals)
80- **TVL**: 134376951329.85631
81**RPC Endpoints**:
82| URL                                          | Tracking |
83|----------------------------------------------|----------|
84| https://eth.llamarpc.com                     | none     |
85| https://go.getblock.io/...                   | none     |
86...
87**Explorers**:
88| Name       | URL                        | Standard |
89|------------|----------------------------|----------|
90| etherscan  | https://etherscan.io       | EIP3091  |
91...
92```
93 
94#### `getChainsByKeyword`
95 
96- **Description**: Searches for blockchains by keyword (case-insensitive partial match).
97- **Parameters**:
98  - `keyword` (string): The keyword or partial name to search (e.g., 'eth').
99  - `limit` (integer, optional): Maximum number of results (default: 5).
100- **Returns**: A Markdown string listing up to `limit` matching chains or an error message.
101 
102**Example Prompt** (in an MCP client):
103```
104Find blockchains with 'eth' in their name, limit to 2 results.
105```
106 
107**Example Response**:
108```markdown
109**Matching Chains**
110 
111### Chain 1
112**Chain Details**
113- **Name**: Ethereum Mainnet
114- **Chain ID**: 1
115- **Native Currency**: Ether (ETH, 18 decimals)
116- **TVL**: 134376951329.85631
117**RPC Endpoints**:
118| URL                                          | Tracking |
119|----------------------------------------------|----------|
120| https://eth.llamarpc.com                     | none     |
121...
122**Explorers**:
123| Name       | URL                        | Standard |
124|------------|----------------------------|----------|
125| etherscan  | https://etherscan.io       | EIP3091  |
126...
127 
128### Chain 2
129**Chain Details**
130- **Name**: Ethereum Goerli
131- **Chain ID**: 5
132- **Native Currency**: Ether (ETH, 18 decimals)
133- **TVL**: N/A
134**RPC Endpoints**:
135| URL                                          | Tracking |
136|----------------------------------------------|----------|
137| https://goerli.infura.io/...                 | yes      |
138...
139**Explorers**:
140| Name       | URL                        | Standard |
141|------------|----------------------------|----------|
142| etherscan  | https://goerli.etherscan.io | EIP3091  |
143...
144```
145 
146## License
147 
148This project is licensed under the MIT License. See the [LICENSE](LICENSE) file for details.
149 
150