ens-mcp
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.
Connect AI assistants to ENS for name lookups, profile information, availability checks, and pricing.
ENS MCP Server
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 withENS_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)
Sign in to leave a review.
Leave a reviewNo results found