Ethereum Name Service (ENS)

🚀 Ethereum Name Service (ENS) MCP Server

This project provides an MCP server for the Ethereum Name Service (ENS), enabling Claude to interact with the ENS system. It supports functions such as domain name resolution, availability checking, and record retrieval.

npm package: https://www.npmjs.com/package/mcp-server-ens

🚀 Quick Start

✨ Features

• Name Resolution: Translate ENS names into Ethereum addresses.
• Reverse Lookup: Retrieve ENS names based on Ethereum addresses.
• Text Record Retrieval: Obtain specific key - value text records for a given ENS name.
• Availability Check: Determine if an ENS name is available for registration.
• All Records Retrieval: Fetch all relevant information about a specified ENS name.
• Sub - domain Retrieval: Get all sub - domains of a given ENS name.
• Name History Check: View the historical records of a specified ENS name.

💻 Usage Examples

Basic Usage

The following are the basic usage examples for different functions provided by the ENS MCP server:

Name Resolution

- **Input**:
    - `name` (string): The ENS name to be resolved (e.g., 'vitalik.eth').
- **Output**: The corresponding Ethereum address or an error message.

Reverse Lookup

- **Input**:
    - `address` (string): The Ethereum address to be queried.
- **Output**: The corresponding ENS name or a prompt indicating that no name was found.

Get Text Record

- **Input**:
    - `name` (string): The ENS name to be queried.
    - `key` (string): The record key to be searched (e.g., 'email', 'url', 'avatar', 'description', 'twitter', etc.).
- **Output**: The value corresponding to the specified key or a prompt indicating that no record was found.

Check Availability

- **Input**:
    - `name` (string): The ENS name to be checked.
- **Output**: The availability status and registration information (if registered).

Get All Records

- **Input**:
    - `name` (string): The ENS name to be queried.
- **Output**: Detailed information including resolver address, text records, address, content hash, ownership, and expiration information.

Get Sub - domains

- **Input**:
    - `name` (string): The ENS name to query sub - domains for.
- **Output**: A list of sub - domains and their owner information.

Get Name History

- **Input**:
    - `name` (string): The ENS name to check the history of.
- **Output**: Historical records related to the name.