Back to Browse

Namewhisper MCP Server

AI & MLUse Caution4.8MCP RegistryLocalRemote
Free

Server data from the Official MCP Registry

44 MCP tools to search, value, register, trade, and manage ENS names. AI-powered intelligence layer.

About

44 MCP tools to search, value, register, trade, and manage ENS names. AI-powered intelligence layer.

Remote endpoints: streamable-http: https://namewhisper.ai/mcp

Security Report

4.8
Use Caution4.8High Risk

NameWhisper MCP is a thin proxy server for ENS domain management with appropriate architecture and reasonable security practices. The server has no direct authentication requirements (as designed), uses environment variables correctly for configuration, and makes legitimate external network calls to its backend API. Some minor code quality observations around error handling and validation exist, but permissions align well with the stated purpose of proxying ENS operations through the NameWhisper backend. Supply chain analysis found 3 known vulnerabilities in dependencies (0 critical, 3 high severity).

3 files analyzed · 7 issues found

Security scores are indicators to help you make informed decisions, not guarantees. Always review permissions before connecting any MCP server.

Permissions Required

This plugin requests these system permissions. Most are normal for its category.

HTTP Network Access

Connects to external APIs or services over the internet.

env_vars

Check that this permission is expected for this type of plugin.

How to Install & Connect

Available as Local & Remote

This plugin can run on your machine or connect to a hosted endpoint. during install.

Documentation

View on GitHub

From the project's GitHub README.

NameWhisper MCP Server

AI-powered ENS intelligence for autonomous agents. Search 3.5M+ names, get valuations, trade, and manage ENS domains — all via the Model Context Protocol.

License: AGPL-3.0 npm MCP

Quick Start

Claude Desktop

Add to ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows):

{
  "mcpServers": {
    "namewhisper": {
      "command": "npx",
      "args": ["-y", "namewhisper-mcp"]
    }
  }
}

Cursor

Add to .cursor/mcp.json in your project root:

{
  "mcpServers": {
    "namewhisper": {
      "command": "npx",
      "args": ["-y", "namewhisper-mcp"]
    }
  }
}

Claude Code

claude mcp add namewhisper -- npx -y namewhisper-mcp

Direct Usage

npx namewhisper-mcp

Remote endpoint (no install)

The same 44 tools are served directly over streamable HTTP — point any remote-capable MCP client at:

https://namewhisper.ai/mcp

For Claude Code:

claude mcp add --transport http namewhisper https://namewhisper.ai/mcp

Server card: namewhisper.ai/.well-known/mcp.json · Registry: ai.namewhisper/ens-tools on the MCP Registry

What It Does

NameWhisper exposes 44 ENS tools over the Model Context Protocol, giving AI agents full access to:

  • Search — natural language queries across 3.5M+ indexed ENS names with semantic vector search
  • Valuation — confidence-rated price estimates using comparable sales, entity recognition, and quality signals
  • Marketplace — browse listings, find underpriced names, check recent sales and offers
  • Commerce — register names, list names for sale, buy listings (single or batch up to 20), make offers, accept offers, cancel listings and offers, bulk register up to 20 names in 2 transactions
  • Management — renew, transfer, set records, wrap/unwrap, manage fuses, create subnames
  • Agent Identity — provision ENSIP-25 agent identities, check ERC-8004 reputation, search the agent directory
  • Knowledge — search ENS governance proposals, protocol docs, and community discussions

Architecture

┌──────────────┐     stdio      ┌────────────────────┐     HTTPS     ┌─────────────────┐
│  AI Client   │ ◄────────────► │  namewhisper-mcp   │ ◄──────────► │ namewhisper.ai  │
│  (Claude,    │    MCP JSON    │  (this package)    │   JSON-RPC   │  (backend)      │
│   Cursor,    │                │                    │              │                 │
│   etc.)      │                │  44 tool schemas   │              │  Valuation      │
└──────────────┘                │  + proxy layer     │              │  Database       │
                                └────────────────────┘              │  Marketplace    │
                                                                    │  On-chain       │
                                                                    └─────────────────┘

This package is a thin proxy. It registers tool schemas locally for your MCP client to discover, then forwards all tool calls to the NameWhisper backend at namewhisper.ai/mcp. The proprietary valuation engine, marketplace aggregation, database, and on-chain transaction building all run server-side.

No API key required. No database. No secrets. Just npx and go.

Tools Reference

Discovery

ToolDescription
search_ens_namesNatural language search with automatic intent detection — filtered, semantic, creative, or bulk availability check
enumerate_entitiesVerified, correctly-spelled label list for a real-world entity category (e.g. "F1 world champions"), grouped by available vs registered
get_name_detailsFull metadata for a name: owner, expiry, tags, listings, offers, ENSIP-25 agent bindings
check_availabilityBulk check registration status for multiple names
get_similar_namesSemantic vector search across 3.5M+ names using 256-dim embeddings
get_expiring_namesNames by lifecycle window — premium (Dutch auction), grace period, or expiring soon, validated on-chain

Intelligence

ToolDescription
get_valuationThree-track valuation: comp-based + quality-reference + self-history. Entity recognition via Wikipedia/Wikidata
get_market_activityRecent sales, listings, offers, mints, transfers, renewals, burns
get_wallet_portfolioAll ENS names owned by a wallet with listings, offers, and expiry data
find_alphaDiscover names listed below comparable-sales valuation with discount % and confidence
wash_checkDetect wash trading in ENS sales using on-chain analysis
get_primary_nameReverse resolution — check what ENS name is set for a wallet address

Commerce

ToolDescription
purchase_nameRegister available names or buy listed names. Auto-detects action, returns transaction recipes
batch_purchaseBuy up to 20 NameWhisper-listed names in one Seaport transaction
sweepFloor-sweep the cheapest N names in a category/filter (bounded by count and/or budget) in one Seaport transaction
create_listingList a name for sale on NameWhisper. Builds unsigned Seaport order for signing
batch_create_listingsBulk-list up to 10 names on NameWhisper in one signing flow (SIP-6 bulk signature)
cancel_listingCancel an active listing via Seaport.cancel() on-chain — invalidates the order across all venues
make_offerSubmit a bid on a registered name with market context
accept_offerSeller-side acceptance of a standing offer. Atomic WETH↔name swap via Seaport.fulfillOrder()
cancel_offerCancel an offer you made via Seaport.cancel() on-chain
bulk_registerBatch register up to 20 names in 2 transactions (commit + register) via Multicall3
renew_ens_nameRenew single or batch names. Any duration, anyone can renew any name
bulk_set_recordsSet resolver records across up to 50 names in one transaction

Management

ToolDescription
transfer_ens_nameTransfer ownership (auto-detects wrapped vs unwrapped)
bulk_transfer_ens_namesBatch transfer up to 20 names in 1 transaction via Multicall3
set_ens_recordsSet address records, text records, content hash, ENSIP-25 agent registration
set_primary_nameSet reverse resolution (primary name) for a wallet
set_resolverChange resolver contract
manage_ens_nameComprehensive status check with renewal pricing and recommendations

NameWrapper

ToolDescription
wrap_nameWrap into NameWrapper (ERC-721 to ERC-1155) with optional fuse burning
unwrap_nameUnwrap back to BaseRegistrar (ERC-1155 to ERC-721)
manage_fusesRead or burn fuses on wrapped names (irreversible)
mint_subnamesBulk create subnames under a parent name
extend_subname_expiryExtend subname expiry within parent bounds

Access & Recovery

ToolDescription
approve_operatorApprove/revoke operator for ENS contracts (setApprovalForAll)
reclaim_nameReclaim ENS Registry ownership from BaseRegistrar token

Agent Identity

ToolDescription
provision_agent_identityOne-call agent identity setup: name recommendations + registration recipe + ENSIP-25 records
register_agentRegister an ENS name as an ERC-8004 agent identity on mainnet (ERC-8217 name-bound or direct-to-wallet)
get_agent_reputationCheck ENSIP-25 agent-registration verification + ERC-8004 reputation
search_agent_directoryFind registered AI agents by capability, reputation, or name
get_caller_identityReturns authenticated identity of the calling agent (requires ERC-8128)

Knowledge & Internal

ToolDescription
search_knowledgeSearch ENS governance, protocol docs, blog posts, forum discussions, Farcaster casts
get_usage_statsSession tool call counts, success rates, and latency

Configuration

Environment VariableDefaultDescription
NAMEWHISPER_URLhttps://namewhisper.aiBackend URL (override for local development)

Copy .env.example to .env to customize. Most users need no configuration.

Links

License

AGPL-3.0

Reviews

No reviews yet

Be the first to review this server!