trackmcp
Back to directory
kukapay

chainlist-mcp

View on GitHub

An MCP server that gives AI agents fast access to verified EVM chain information, including RPC URLs, chain IDs, explorers, and native tokens.

2 stars PythonAI & Machine Learning Updated Jun 13, 2025

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.

GitHub License
Python Version
Status

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:

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

2. Install Dependencies:

bash
uv sync

3. Installing to Claude Desktop:

Install the server as a Claude Desktop application:

bash
uv run mcp install cli.py --name "Chainlist MCP"

Configuration file as a reference:

json
{
       "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):

code
Get the details for the blockchain with chain ID 1.

Example Response:

markdown
**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):

code
Find blockchains with 'eth' in their name, limit to 2 results.

Example Response:

markdown
**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.

Frequently asked questions

What is chainlist-mcp?

chainlist-mcp is An MCP server that gives AI agents fast access to verified EVM chain information, including RPC URLs, chain IDs, explorers, and native tokens.

How do I install chainlist-mcp?

Open the GitHub repository and follow its README. Most MCP servers are added to your client's MCP config, then called by your agent.

Is chainlist-mcp open source?

Yes — it is hosted on GitHub at https://github.com/kukapay/chainlist-mcp and has 2 stars.

Related MCP tools

All-Hands-AIopenhands

🙌 OpenHands: Code Less, Make More for the Model Context Protocol. Enhance AI assistants with powerful integrations. Python-based implementation.

64,677 Python
agentartificial-intelligencechatgpt+6
mem0aimem0

Universal memory layer for AI Agents; Announcing OpenMemory MCP - local and secure memory management. Python-based implementation.

42,646 Python
agentsaiai-agents+12
zhayujiechatgpt-on-wechat

基于大模型搭建的聊天机器人，同时支持 微信公众号、企业微信应用、飞书、钉钉 等接入，可选择ChatGPT/Claude/DeepSeek/文心一言/讯飞星火/通义千问/ Gemini/GLM-4/Kimi/LinkAI，能处理文本、语音和图片，访问操作系统和互联网，支持基于自有知识库进行定制企业智能客服。

39,573 Python
aiai-agentchatgpt+17
assafelovicgpt-researcher

An LLM agent that conducts deep research (local and web) on any given topic and generates a long report with citations. Built for the Model Context Protocol to

24,026 Python
agentaiautomation+8
jlowinfastmcp

🚀 The fast, Pythonic way to build MCP servers and clients Trusted by 19900+ developers. Trusted by 19900+ developers. Trusted by 19900+ developers.

19,927 Python
agentsfastmcpllms+6
1Panel-devmaxkb

🔥 MaxKB is an open-source platform for building enterprise-grade agents. MaxKB 是强大易用的开源企业级智能体平台。 for the Model Context Protocol. Enhance AI assistants with po

19,062 Python
agentagentic-aichatbot+11

Run your own MCP server? See who uses it and what to fix.

Measure it with TrackMCP