ens

This MCP server provides tools to interact with the Ethereum Name Service (ENS) via Claude. It exposes a set of commands that let you resolve ENS names to Ethereum addresses, perform reverse lookups, fetch and inspect text records, check name availability, retrieve all records for a name, list subdomains, view name history, and obtain pricing information for registrations. Each tool is designed to be called through the MCP server interface and returns structured results or clear error messages when something goes wrong. To use it, configure the MCP server in Claude's CLI integration (claude_desktop_config.json or Claude Code) and then invoke the desired tool by name with the appropriate inputs.

Prerequisites:

• Node.js (v16 or higher)
• npm or yarn
• Access to Ethereum RPC providers (public or private)

Installation steps:

1. Clone the repository or set up a new project:

git clone https://github.com/JustaName-id/ens-mcp-server

2. Install dependencies:

npm i

3. Configure Ethereum providers (optional): create a .env file in the project root and add PROVIDER_URL with comma-separated URLs. Example:

PROVIDER_URL=https://your-provider-url.com,https://your-backup-provider.com

If PROVIDER_URL is not set, the server will use default providers:

• https://eth.drpc.org
• https://eth.llamarpc.com
• https://ethereum.publicnode.com
• https://rpc.ankr.com/eth

4. Run or package the server as needed (the README indicates npm packaging via the npm registry and usage via npx or locally).

Notes and tips:

• PROVIDER_URL is optional but recommended for reliability; specify multiple providers as a comma-separated list.
• The server exposes multiple tools; ensure you pass correct input types (e.g., ENS name format like vitalik.eth, Ethereum addresses starting with 0x, etc.).
• If you encounter network or provider errors, verify provider URLs are reachable and consider adding more providers to the PROVIDER_URL list.
• When integrating with Claude, use the provided examples to configure mcpServers in claude_desktop_config.json or via Claude Code commands.
• This MCP server is published as an npm package mcp-server-ens; keep an eye on updates for new ENS features or API changes.