ens-mcp

mcp
Security Audit
Pass
Health Pass
  • License — License: Apache-2.0
  • Description — Repository has a description
  • Active repo — Last push 0 days ago
  • Community trust — 15 GitHub stars
Code Pass
  • Code scan — Scanned 12 files during light audit, no dangerous patterns found
Permissions Pass
  • Permissions — No dangerous permissions requested

No AI report is available for this listing yet.

SUMMARY

Connect AI assistants to ENS for name lookups, profile information, availability checks, and pricing.

README.md

ENS MCP Server

Install in Cursor
Install in VS Code
npm version

Give your AI assistant native access to ENS, the Ethereum Name Service. Resolve names, read
profiles and records, see who controls a name, browse the names an address holds, check prices,
and prepare registrations and changes for your own wallet, all through natural language.

The server never signs or sends transactions: it prepares and simulates them, and you sign.

Installation

Connect to the hosted ENS MCP server:

https://ens-mcp.namespace.ninja/mcp
Claude Code
claude mcp add --transport http ens https://ens-mcp.namespace.ninja/mcp
Claude Desktop and claude.ai

Open Settings > Connectors > Add custom connector and enter:

https://ens-mcp.namespace.ninja/mcp

Or run the server locally: add to claude_desktop_config.json (macOS:
~/Library/Application Support/Claude/, Windows: %APPDATA%\Claude\):

{
  "mcpServers": {
    "ens": {
      "command": "npx",
      "args": ["-y", "@thenamespace/ens-mcp"]
    }
  }
}
Cursor

Add to ~/.cursor/mcp.json:

{
  "mcpServers": {
    "ens": {
      "url": "https://ens-mcp.namespace.ninja/mcp"
    }
  }
}
VS Code

Add to .vscode/mcp.json:

{
  "servers": {
    "ens": {
      "type": "http",
      "url": "https://ens-mcp.namespace.ninja/mcp"
    }
  }
}
Codex
codex mcp add ens --url https://ens-mcp.namespace.ninja/mcp
Gemini CLI

Add to ~/.gemini/settings.json:

{
  "mcpServers": {
    "ens": {
      "httpUrl": "https://ens-mcp.namespace.ninja/mcp"
    }
  }
}
OpenCode

Add to your opencode.json:

{
  "mcp": {
    "ens": {
      "type": "remote",
      "url": "https://ens-mcp.namespace.ninja/mcp",
      "enabled": true
    }
  }
}
Windsurf

Add to ~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "ens": {
      "serverUrl": "https://ens-mcp.namespace.ninja/mcp"
    }
  }
}
Zed

Add to your Zed settings:

{
  "context_servers": {
    "ens": {
      "url": "https://ens-mcp.namespace.ninja/mcp"
    }
  }
}
Warp

Go to Settings > MCP Servers > Add MCP Server and add:

{
  "ens": {
    "url": "https://ens-mcp.namespace.ninja/mcp"
  }
}
Kiro

Add to ~/.kiro/settings/mcp.json:

{
  "mcpServers": {
    "ens": {
      "url": "https://ens-mcp.namespace.ninja/mcp"
    }
  }
}
Roo Code

Add to your Roo Code MCP config:

{
  "mcpServers": {
    "ens": {
      "type": "streamable-http",
      "url": "https://ens-mcp.namespace.ninja/mcp"
    }
  }
}
Antigravity

Open the MCP Store panel (from the "..." menu in the side panel), then add a custom server with:

https://ens-mcp.namespace.ninja/mcp
Other clients

For clients that support remote MCP servers:

{
  "mcpServers": {
    "ens": {
      "url": "https://ens-mcp.namespace.ninja/mcp"
    }
  }
}

For clients that only launch local servers:

{
  "mcpServers": {
    "ens": {
      "command": "npx",
      "args": ["-y", "@thenamespace/ens-mcp"]
    }
  }
}
Self-hosting

Run the server yourself to pick the chain, your RPC and the toolsets. It needs Node.js 26 or later.

npx -y @thenamespace/ens-mcp                         # stdio
npx -y @thenamespace/ens-mcp --http --port 8080      # http://127.0.0.1:8080/mcp
Variable Description Default
ENS_MCP_RPC_URL RPC URL for the chain a public RPC
ENS_MCP_CHAIN mainnet or sepolia mainnet
ENS_MCP_TOOLSETS Toolsets to enable, comma-separated, or all lookup,lists,register,utils

Every option, HTTP, Docker and rate limits: docs/self-hosting.md.

The hosted server reads Ethereum mainnet and allows 60 requests per minute per IP. To keep your
lookups to yourself, or to use Sepolia or the advanced tools, run it locally.

💬 Example questions

Once ENS MCP is installed, you can ask things like:

1️⃣ Basic lookup

> Who owns vitalik.eth, and when does it expire?

2️⃣ Records and addresses

> Give me the ETH and Solana addresses and the Twitter handle for nick.eth.

3️⃣ Reverse lookup

> What is the primary name of 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045?

4️⃣ Portfolio

> Which ENS names does vitalik.eth hold, and which expire in the next 90 days?

5️⃣ Subnames

> List the subnames of base.eth.

6️⃣ History

> When did vitalik.eth last change its content hash?

7️⃣ Availability and price

> Is coolname.eth available? How much is it for 2 years, and if it's taken, who owns it?

8️⃣ Registration

> Register coolname.eth for 1 year for my wallet 0x… and set it as my primary name.

9️⃣ Profile changes

> Set my avatar and Twitter handle on alice.eth. I'm signing with alice.eth.

🔟 Follow-up

> I sent the commit transaction, here's the hash. What now?

Available tools

Tools come in toolsets. The hosted server has every toolset but advanced; locally, choose with
ENS_MCP_TOOLSETS.

Toolset Tools
lookup resolve_name, get_primary_name, get_profile, get_records, get_name_details, get_permissions
lists search_names, list_names_for_address, list_subnames, get_name_history, list_expiring_names, get_indexer_status
register check_availability, get_price, register_name, renew_names
manage set_records, set_primary_name, create_subname, update_subname, remove_subname, transfer_name, set_resolver
advanced wrap_name, unwrap_name, set_fuses, grant_roles, revoke_roles, set_record_access, set_approval, migrate_name, DNS names, …
utils normalize_name, convert_coin_type, convert_content_hash

The toolsets that prepare transactions also bring get_plan and get_plan_status. The server
offers resources (ens://name/{name} and more), workflow prompts and an ens agent skill too.

Documentation

  • Tools: every tool, resource, prompt and the skill
  • Transactions: how changes are prepared, signed and followed
  • Self-hosting: configuration, HTTP, Docker, the hosted server

Contributing

Contributions are welcome. See CONTRIBUTING.md to set up the repository, and
SECURITY.md to report a vulnerability.


Built with ❤️ by Namespace Ninjas 🥷

Reviews (0)

No results found