{
  "markdown": "# NameWhisper MCP Server\n\nAI-powered ENS intelligence for autonomous agents. Search 3.5M+ names, get valuations, trade, and manage ENS domains — all via the Model Context Protocol.\n\n[![License: AGPL-3.0](https://img.shields.io/badge/License-AGPL--3.0-blue.svg)](LICENSE)\n[![npm](https://img.shields.io/npm/v/namewhisper-mcp)](https://www.npmjs.com/package/namewhisper-mcp)\n[![MCP](https://img.shields.io/badge/MCP-compatible-green)](https://modelcontextprotocol.io)\n\n## Quick Start\n\n### Claude Desktop\n\nAdd to `~/Library/Application Support/Claude/claude_desktop_config.json` (macOS) or `%APPDATA%\\Claude\\claude_desktop_config.json` (Windows):\n\n```json\n{\n  \"mcpServers\": {\n    \"namewhisper\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"namewhisper-mcp\"]\n    }\n  }\n}\n```\n\n### Cursor\n\nAdd to `.cursor/mcp.json` in your project root:\n\n```json\n{\n  \"mcpServers\": {\n    \"namewhisper\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"namewhisper-mcp\"]\n    }\n  }\n}\n```\n\n### Claude Code\n\n```bash\nclaude mcp add namewhisper -- npx -y namewhisper-mcp\n```\n\n### Direct Usage\n\n```bash\nnpx namewhisper-mcp\n```\n\n### Remote endpoint (no install)\n\nThe same 44 tools are served directly over streamable HTTP — point any remote-capable MCP client at:\n\n```\nhttps://namewhisper.ai/mcp\n```\n\nFor Claude Code:\n\n```bash\nclaude mcp add --transport http namewhisper https://namewhisper.ai/mcp\n```\n\nServer card: [namewhisper.ai/.well-known/mcp.json](https://namewhisper.ai/.well-known/mcp.json) · Registry: `ai.namewhisper/ens-tools` on the [MCP Registry](https://registry.modelcontextprotocol.io)\n\n## What It Does\n\nNameWhisper exposes **44 ENS tools** over the Model Context Protocol, giving AI agents full access to:\n\n- **Search** — natural language queries across 3.5M+ indexed ENS names with semantic vector search\n- **Valuation** — confidence-rated price estimates using comparable sales, entity recognition, and quality signals\n- **Marketplace** — browse listings, find underpriced names, check recent sales and offers\n- **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\n- **Management** — renew, transfer, set records, wrap/unwrap, manage fuses, create subnames\n- **Agent Identity** — provision ENSIP-25 agent identities, check ERC-8004 reputation, search the agent directory\n- **Knowledge** — search ENS governance proposals, protocol docs, and community discussions\n\n## Architecture\n\n```\n┌──────────────┐     stdio      ┌────────────────────┐     HTTPS     ┌─────────────────┐\n│  AI Client   │ ◄────────────► │  namewhisper-mcp   │ ◄──────────► │ namewhisper.ai  │\n│  (Claude,    │    MCP JSON    │  (this package)    │   JSON-RPC   │  (backend)      │\n│   Cursor,    │                │                    │              │                 │\n│   etc.)      │                │  44 tool schemas   │              │  Valuation      │\n└──────────────┘                │  + proxy layer     │              │  Database       │\n                                └────────────────────┘              │  Marketplace    │\n                                                                    │  On-chain       │\n                                                                    └─────────────────┘\n```\n\nThis 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.\n\nNo API key required. No database. No secrets. Just `npx` and go.\n\n## Tools Reference\n\n### Discovery\n\n| Tool | Description |\n|------|-------------|\n| `search_ens_names` | Natural language search with automatic intent detection — filtered, semantic, creative, or bulk availability check |\n| `enumerate_entities` | Verified, correctly-spelled label list for a real-world entity category (e.g. \"F1 world champions\"), grouped by available vs registered |\n| `get_name_details` | Full metadata for a name: owner, expiry, tags, listings, offers, ENSIP-25 agent bindings |\n| `check_availability` | Bulk check registration status for multiple names |\n| `get_similar_names` | Semantic vector search across 3.5M+ names using 256-dim embeddings |\n| `get_expiring_names` | Names by lifecycle window — premium (Dutch auction), grace period, or expiring soon, validated on-chain |\n\n### Intelligence\n\n| Tool | Description |\n|------|-------------|\n| `get_valuation` | Three-track valuation: comp-based + quality-reference + self-history. Entity recognition via Wikipedia/Wikidata |\n| `get_market_activity` | Recent sales, listings, offers, mints, transfers, renewals, burns |\n| `get_wallet_portfolio` | All ENS names owned by a wallet with listings, offers, and expiry data |\n| `find_alpha` | Discover names listed below comparable-sales valuation with discount % and confidence |\n| `wash_check` | Detect wash trading in ENS sales using on-chain analysis |\n| `get_primary_name` | Reverse resolution — check what ENS name is set for a wallet address |\n\n### Commerce\n\n| Tool | Description |\n|------|-------------|\n| `purchase_name` | Register available names or buy listed names. Auto-detects action, returns transaction recipes |\n| `batch_purchase` | Buy up to 20 NameWhisper-listed names in one Seaport transaction |\n| `sweep` | Floor-sweep the cheapest N names in a category/filter (bounded by count and/or budget) in one Seaport transaction |\n| `create_listing` | List a name for sale on NameWhisper. Builds unsigned Seaport order for signing |\n| `batch_create_listings` | Bulk-list up to 10 names on NameWhisper in one signing flow (SIP-6 bulk signature) |\n| `cancel_listing` | Cancel an active listing via Seaport.cancel() on-chain — invalidates the order across all venues |\n| `make_offer` | Submit a bid on a registered name with market context |\n| `accept_offer` | Seller-side acceptance of a standing offer. Atomic WETH↔name swap via Seaport.fulfillOrder() |\n| `cancel_offer` | Cancel an offer you made via Seaport.cancel() on-chain |\n| `bulk_register` | Batch register up to 20 names in 2 transactions (commit + register) via Multicall3 |\n| `renew_ens_name` | Renew single or batch names. Any duration, anyone can renew any name |\n| `bulk_set_records` | Set resolver records across up to 50 names in one transaction |\n\n### Management\n\n| Tool | Description |\n|------|-------------|\n| `transfer_ens_name` | Transfer ownership (auto-detects wrapped vs unwrapped) |\n| `bulk_transfer_ens_names` | Batch transfer up to 20 names in 1 transaction via Multicall3 |\n| `set_ens_records` | Set address records, text records, content hash, ENSIP-25 agent registration |\n| `set_primary_name` | Set reverse resolution (primary name) for a wallet |\n| `set_resolver` | Change resolver contract |\n| `manage_ens_name` | Comprehensive status check with renewal pricing and recommendations |\n\n### NameWrapper\n\n| Tool | Description |\n|------|-------------|\n| `wrap_name` | Wrap into NameWrapper (ERC-721 to ERC-1155) with optional fuse burning |\n| `unwrap_name` | Unwrap back to BaseRegistrar (ERC-1155 to ERC-721) |\n| `manage_fuses` | Read or burn fuses on wrapped names (irreversible) |\n| `mint_subnames` | Bulk create subnames under a parent name |\n| `extend_subname_expiry` | Extend subname expiry within parent bounds |\n\n### Access & Recovery\n\n| Tool | Description |\n|------|-------------|\n| `approve_operator` | Approve/revoke operator for ENS contracts (setApprovalForAll) |\n| `reclaim_name` | Reclaim ENS Registry ownership from BaseRegistrar token |\n\n### Agent Identity\n\n| Tool | Description |\n|------|-------------|\n| `provision_agent_identity` | One-call agent identity setup: name recommendations + registration recipe + ENSIP-25 records |\n| `register_agent` | Register an ENS name as an ERC-8004 agent identity on mainnet (ERC-8217 name-bound or direct-to-wallet) |\n| `get_agent_reputation` | Check ENSIP-25 agent-registration verification + ERC-8004 reputation |\n| `search_agent_directory` | Find registered AI agents by capability, reputation, or name |\n| `get_caller_identity` | Returns authenticated identity of the calling agent (requires ERC-8128) |\n\n### Knowledge & Internal\n\n| Tool | Description |\n|------|-------------|\n| `search_knowledge` | Search ENS governance, protocol docs, blog posts, forum discussions, Farcaster casts |\n| `get_usage_stats` | Session tool call counts, success rates, and latency |\n\n## Configuration\n\n| Environment Variable | Default | Description |\n|---------------------|---------|-------------|\n| `NAMEWHISPER_URL` | `https://namewhisper.ai` | Backend URL (override for local development) |\n\nCopy `.env.example` to `.env` to customize. Most users need no configuration.\n\n## Links\n\n- **NameWhisper** — [namewhisper.ai](https://namewhisper.ai)\n- **Developer docs** — [namewhisper.ai/docs](https://namewhisper.ai/docs)\n- **Agent integration guide** — [namewhisper.ai/guide](https://namewhisper.ai/guide)\n- **llms.txt** — [namewhisper.ai/llms.txt](https://namewhisper.ai/llms.txt)\n- **MCP Specification** — [modelcontextprotocol.io](https://modelcontextprotocol.io)\n- **ENSIP-25** — [Agent identity standard for ENS](https://docs.ens.domains/ensip/25/)\n- **ERC-8004** — [Trustless Agents](https://eips.ethereum.org/EIPS/eip-8004)\n\n## License\n\n[AGPL-3.0](LICENSE)\n",
  "bytes": 9401,
  "sha": "3fd619d61fe43248149762d5701fae7f211632e8bf0491eabc6f9457dd7ed2c0",
  "repo_slug": "eggybug42069/namewhisper-mcp",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_ai_namewhisper_ens_tools_6b3cf351/readme"
}