ENS

An MCP server that resolves, analyzes, and contextualizes ENS domain activity.

python

1

GitHub Stars

python

Language

6 months ago

First Indexed

2 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "kukapay-ens-mcp": {
      "command": "uv",
      "args": [
        "--directory",
        "/path/to/ens-mcp",
        "run",
        "main.py"
      ],
      "env": {
        "THEGRAPH_API_KEY": "your_graph_api_key"
      }
    }
  }
}

This MCP server resolves, analyzes, and contextualizes ENS domain activity to give you human-readable identity insights. It lets you map ENS names to addresses, view detailed domain data, and review the domain’s event history from a single, pluggable service.

How to use

You run this MCP server and connect it to your MCP client to access three core capabilities: resolve ENS names to Ethereum addresses, fetch detailed information about an ENS domain, and retrieve the domain’s event history. Use these tools to build dashboards, automate lookups, or power agents that need trustworthy ENS context in your Web3 workflows.

How to install

Prerequisites you need installed on your machine before you begin:

Step 1. Clone the MCP server repository and navigate into it.

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

Step 2. Install dependencies and prepare the server for running.

uv sync

Step 3. Install as a Claude Desktop application so you can start the MCP server like a desktop service.

uv run mcp install main.py --name "ens-mcp"

Step 4. Use the following configuration snippet as a reference to run the MCP server with the required environment variable.

{
  "mcpServers": {
    "ens-mcp": {
      "command": "uv",
      "args": [ "--directory", "/path/to/ens-mcp", "run", "main.py" ],
      "env": { "THEGRAPH_API_KEY": "the_graph_api_key"}
    }
  }
}

Replace /path/to/ens-mcp with your actual installation path, and the_graph_api_key with your API key from The Graph.


Step 5. Start the MCP server using your preferred method (the one shown above will run the server under Claude Desktop). Ensure the THEGRAPH\_API\_KEY environment variable is set to your the Graph API key before starting.

## Configuration and tools

This server exposes three MCP tools you can call from your MCP client:

- resolve\_ens\_name(domain: str) -> str — resolves an ENS domain to its Ethereum address.

- get\_domain\_details(domain: str) -> str — fetches detailed information about an ENS domain.

- get\_domain\_events(domain: str) -> str — retrieves events associated with an ENS domain.

## Notes and security

- Ensure your The Graph API key remains confidential and is only used by the MCP server in your trusted environment.

## Usage examples and endpoints

Common workflows include resolving a domain to verify ownership, pulling detailed domain attributes for audits, and reviewing recent transfers or resolver changes to understand domain activity over time.

## Available tools

### resolve\_ens\_name

Resolves an ENS domain to its Ethereum address.

### get\_domain\_details

Fetches detailed information about an ENS domain including address, owner, registrant, expiry, and resolver details.

### get\_domain\_events

Retrieves events associated with an ENS domain such as transfers and resolver changes.