Chainlist

You deploy this MCP server to give AI agents fast access to verified Chainlist data, including RPC URLs, chain IDs, explorers, and native tokens. It caches Chainlist data for efficiency, supports flexible searches, and returns readable Markdown with tabulated endpoints and explorers.

How to use

You interact with this server using MCP-compatible clients. Two primary tools let you retrieve blockchain information: getChainById and getChainsByKeyword. Use getChainById to fetch details for a specific chain ID and getChainsByKeyword to search for chains by name or keyword. The server returns results formatted as Markdown to be easy to read and integrate into your chat or tooling.

Practical usage ideas include querying Ethereum mainnet details by its chain ID, listing chains that match a partial keyword like “eth,” and incorporating the results into your automation workflows where readable chain data improves decision making and routing for AI agents.

How to install

Prerequisites you need before installation are Python 3.10 or higher and uv to manage Python projects and dependencies.

Step by step installation commands you should run in your shell:

Clone the repository and enter the project folder.

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

How to install

Install dependencies and prepare the MCP runtime using uv, then install the server as a Claude Desktop application.

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

How to install

Configure the MCP server in your environment after installation. The following example shows how to reference the Chainlist MCP in a configuration file.

{
  "mcpServers": {
    "Chainlist MCP": {
      "command": "uv",
      "args": ["--directory", "/path/to/chainlist-mcp", "run", "main.py"]
    }
  }
}

Additional notes

If you are using Claude Desktop, you can install the server with the provided runtime and ensure the directory path is accurate for your installation. Be sure to replace "/path/to/chainlist-mcp" with the actual path where you cloned the project.

Available tools

getChainById

Retrieves details of a blockchain by its chain ID and returns a Markdown-formatted summary with chain name, ID, native currency, TVL, RPC endpoints, and explorers.

getChainsByKeyword

Searches for blockchains by a keyword (case-insensitive, partial match) and returns up to a specified limit of matching chains, each with detailed chain information and outputs in Markdown.