Repository avatar
Other Tools
v0.1.0
active

ens-mcp

io.github.thenamespace/ens-mcp

ENS names: resolve, read profiles and ownership, list names, prepare registrations and changes

Documentation

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
VariableDescriptionDefault
ENS_MCP_RPC_URLRPC URL for the chaina public RPC
ENS_MCP_CHAINmainnet or sepoliamainnet
ENS_MCP_TOOLSETSToolsets to enable, comma-separated, or alllookup,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.

ToolsetTools
lookupresolve_name, get_primary_name, get_profile, get_records, get_name_details, get_permissions
listssearch_names, list_names_for_address, list_subnames, get_name_history, list_expiring_names, get_indexer_status
registercheck_availability, get_price, register_name, renew_names
manageset_records, set_primary_name, create_subname, update_subname, remove_subname, transfer_name, set_resolver
advancedwrap_name, unwrap_name, set_fuses, grant_roles, revoke_roles, set_record_access, set_approval, migrate_name, DNS names, …
utilsnormalize_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 🥷

NPM
@thenamespace/ens-mcp
Install Command
npm install @thenamespace/ens-mcp