Chainlist MCP Server

Chainlist MCP Server

Fast, structured EVM chain info for AI agents via the Model Context Protocol

2
Stars
2
Forks
2
Watchers
1
Issues
Chainlist MCP Server enables AI agents and MCP-compatible clients to quickly access and search verified EVM blockchain data. It sources data from Chainlist.org and provides efficient REST-like tools for retrieving details by chain ID or searching by keyword. The server outputs structured Markdown responses, supporting AI context integration with tabulated RPC endpoints and explorers for clarity.

Key Features

Exposes tools via the Model Context Protocol (MCP)
Fetches and caches verified EVM chain information from Chainlist.org
Provides efficient search by chain ID and keyword
Delivers Markdown-formatted, tabulated responses for easy parsing and display
Minimizes requests with smart cache management
Configurable server suitable for integration with Claude Desktop and MCP clients
Supports flexible, regex-based keyword matching
Python 3.10+ compatible and uv dependency management
Ready-to-use example prompts and responses
Aggregates limited- or full-chain search results by user-defined limits

Use Cases

Supplying structured blockchain data to AI agents and chatbots
Enabling model-context-aware search and retrieval of EVM chain info
Populating digital assistants or wallets with up-to-date chain configuration details
Automating RPC endpoint discovery for network monitoring tools
Integrating with development environments that need reliable chain metadata
Supporting AI-driven dApp deployment or testing routines
Simplifying chain-explorer link provisioning for block and transaction lookups
Streamlining onboarding for new chain integrations in multi-chain apps
Enhancing technical documentation with standardized, embeddable chain info
Accelerating research and analysis for blockchain-coverage platforms

README

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

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

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.

Star History

Star History Chart

Repository Owner

kukapay
kukapay

User

Repository Details

Language Python
Default Branch main
Size 17 KB
Contributors 1
License MIT License
MCP Verified Nov 12, 2025

Programming Languages

Python
100%

Tags

Join Our Newsletter

Stay updated with the latest AI tools, news, and offers by subscribing to our weekly newsletter.

We respect your privacy. Unsubscribe at any time.

Related MCPs

Discover similar Model Context Protocol servers

  • EVM MCP Server

    EVM MCP Server

    Unified Model Context Protocol server for multi-chain EVM blockchain access

    EVM MCP Server provides a comprehensive Model Context Protocol-compliant interface for blockchain services across 30+ EVM-compatible networks. It enables AI agents and other clients to interact programmatically with Ethereum, Optimism, Arbitrum, Base, Polygon, and more via standardized tools and resources. Features include blockchain data access, smart contract interactions, token transfers (including NFTs), ENS name resolution, and multi-network support. The server ensures a consistent and context-aware interface for AI and software agents to discover and leverage on-chain functionality.

    • 340
    • MCP
    • mcpdotdirect/evm-mcp-server
  • EVM MCP Server

    EVM MCP Server

    A Model Context Protocol server providing full access to EVM JSON-RPC methods.

    EVM MCP Server is a comprehensive MCP (Model Context Protocol) server offering seamless access to Ethereum Virtual Machine (EVM) JSON-RPC methods across all major EVM-compatible networks. It enables integration with node providers like Infura, Alchemy, QuickNode, and local nodes, offering 20+ specialized tools for blockchain interaction. Users can configure it easily with Claude Desktop for AI-driven workflows and manage blockchain data, transactions, and events through a standardized context protocol.

    • 0
    • MCP
    • JamesANZ/evm-mcp
  • Web3 Jobs MCP Server

    Web3 Jobs MCP Server

    AI-ready MCP server delivering curated, real-time Web3 job listings.

    Web3 Jobs MCP Server provides real-time access to curated Web3 job listings from web3.career through a Model Context Protocol (MCP) interface, enabling intelligent job discovery for AI agents. The server supports advanced filtering by location, remote status, job tag, and result limits, and returns results in Markdown format. It enables the generation of natural language prompts for job searches, facilitating seamless integration with AI platforms such as Claude Desktop. Designed for Python 3.10+, it offers flexible deployment and configuration options.

    • 4
    • MCP
    • kukapay/web3-jobs-mcp
  • Blockchain MCP powered by Tatum

    Blockchain MCP powered by Tatum

    MCP server for universal blockchain data access across 130+ networks.

    Blockchain MCP powered by Tatum is a Model Context Protocol (MCP) server that enables large language models (LLMs) to read and write blockchain data across more than 130 networks. It provides unified access to both the Tatum Blockchain Data API and direct RPC gateways, supporting tools for retrieving balances, portfolios, transactions, and more. The platform is designed for seamless integration via API key and configurable MCP client setups, making it easier to build blockchain-aware AI solutions. Comprehensive documentation and extensive network compatibility facilitate robust development and scalability.

    • 12
    • MCP
    • tatumio/blockchain-mcp
  • Crypto News MCP Server

    Crypto News MCP Server

    Real-time cryptocurrency news and summaries for AI agents via Model Context Protocol.

    Crypto News MCP Server provides real-time cryptocurrency news and article search services to AI agents using the Model Context Protocol. It aggregates news from NewsData and exposes tools for fetching the latest headlines, keyword-based article search with pagination, and prompt generation for LLM-powered summarization. The server is compatible with MCP clients and can be integrated as a plugin for platforms like Claude Desktop.

    • 10
    • MCP
    • kukapay/crypto-news-mcp
  • Web3 MCP

    Web3 MCP

    A Model Context Protocol server for unified blockchain data access.

    Web3 MCP is a Model Context Protocol server that provides access to blockchain data through Ankr's Advanced API. It allows large language models to interact seamlessly with multiple blockchain networks such as Ethereum, BSC, Polygon, and Avalanche. With support for NFT, token, and blockchain query APIs, it enables users and AI agents to retrieve on-chain data, statistics, and analytics efficiently within an MCP context.

    • 3
    • MCP
    • tumf/web3-mcp
  • Didn't find tool you were looking for?

    Be as detailed as possible for better results