# ENS.Tools — ENS Domain Management & Marketplace

> ENS.Tools is a free, non-custodial web app for finding, trading, and managing Ethereum Name Service (ENS) domains. Browse 26k+ marketplace listings with atomic 2% fees via Seaport, discover expiring premium names, search the namespace with AI, and manage your portfolio. Also exposes tools to AI agents via Model Context Protocol.

## Intent-based navigation

Routes are organised by user intent: `/find/*` (discover), `/trade/*` (buy+sell), `/manage/*` (your domains).

### Find
- https://ens.tools/find/expiry — Expiry Explorer: domains in grace period, temp premium, and just-dropped windows
- https://ens.tools/find/search — AI-powered semantic search for available ENS names
- https://ens.tools/find/discover — Collections, leaderboards, featured profiles

### Trade
- https://ens.tools/trade — Marketplace browse, filter, and buy
- https://ens.tools/trade/list — List your names for sale
- https://ens.tools/trade/activity — Recent sales and listings feed
- https://ens.tools/trade/collections — Curated collections (999 Club, 10k Club, emoji domains, etc.)
- https://ens.tools/trade/bulk-list — List multiple names in one flow
- https://ens.tools/trade/offers — Collection-level offers

### Manage (wallet-connected)
- https://ens.tools/manage — Portfolio dashboard with expiry urgency indicators
- https://ens.tools/manage/bulk-edit — Edit records across many domains in one tx
- https://ens.tools/manage/watchlist — Track domains you don't own, get notified before expiry
- https://ens.tools/manage/primary — Set primary name across L1 + L2 chains
- https://ens.tools/manage/gas — Renewal gas-savings calculator
- https://ens.tools/manage/notifications — Expiry alerts + price notifications

### Standalone
- https://ens.tools/network — ENS ecosystem-wide analytics (BigQuery)
- https://ens.tools/profile — Public profile for any ENS name or wallet
- https://ens.tools/u/{name.eth} — Shareable Web3 identity page
- https://ens.tools/domain/{name.eth} — Full domain detail with records, history, ENSIP-25 verification

## Programmatic expiry indexes

Curated landing pages for high-intent expiring-name searches:

- https://ens.tools/find/expiry/3-letter, /4-letter, /5-letter (length)
- https://ens.tools/find/expiry/3-digit, /4-digit, /5-digit (numeric)
- https://ens.tools/find/expiry/999-club, /10k-club, /100k-club
- https://ens.tools/find/expiry/palindrome, /emoji, /zeros
- https://ens.tools/find/expiry/<YYYY-MM> (e.g. /find/expiry/2026-05)

## For AI agents

### MCP Server
- Manifest: https://ens.tools/.well-known/mcp.json
- ChatGPT-style plugin manifest: https://ens.tools/.well-known/ai-plugin.json
- Endpoint: https://ens.tools/.netlify/functions/mcp
- Protocol: Model Context Protocol 2024-11-05 (streamable-http, no auth)
- Tools (15): lookup_domain, check_expiry, search_domains, get_owner_domains, check_agent_verification, is_name_available, get_name_price, get_subnames_for_name, get_name_history, estimate_domain_value, get_gas_estimate, marketplace_search, marketplace_listing, marketplace_stats, resolve_chain

### ENSIP-25 AI agent verification
ENS.Tools reads and writes the `agent-registration[registry][agentId]` text record on any domain. View verification status on any domain detail page.
- Spec: https://ensip25.ens.domains/
- Set records: https://ens.tools/domain/{name.eth} → Records Editor
- Programmatic check: MCP `check_agent_verification` tool

### Machine-readable docs
- Short: https://ens.tools/llms.txt (this file)
- Full: https://ens.tools/llms-full.txt (extended reference with examples)

## Standards support
- ENSIP-25 — AI agent identity verification via `agent-registration` text records
- ERC-7828 — Multi-chain `name@chain` addressing (on.eth chain registry)
- ERC-8004 — On-chain agent registry
- Seaport 1.6 — Marketplace fills with atomic 2% platform fee

## Tech stack
- Frontend: React 18 + Vite + TypeScript + TailwindCSS
- Wallet auth: Privy (MetaMask, WalletConnect, Coinbase Wallet, etc.)
- Chain reads: viem (primary), ethers.js (renewal contract)
- Hosting: Netlify (functions + edge functions)
- Analytics: Plausible (privacy-first, no cookies)
- Mailing list: POST /.netlify/functions/mailing-list-subscribe

## Powered by — third-party services we build on

- ENSNode (https://ensnode.io) — primary subgraph indexer for all ENS read paths
- ENSRainbow (https://ensrainbow.io) — label healing for `[hash]` labelhash preimages
- NameGuard (https://nameguard.io) — name impersonation + visual-confusable detection
- NameAI (https://nameai.io) — naming AI primitives used in search
- NameGraph (https://namegraph.dev) — name relationship graph
- web3.bio (https://web3.bio) — cross-platform linked-identity lookup
- Seaport (https://github.com/ProjectOpenSea/seaport) — atomic marketplace settlement
- Reservoir (https://reservoir.tools) — orderbook aggregation
- LiFi (https://li.fi) — cross-chain bridging for L2 → L1 registration funds
- The Graph — fallback subgraph endpoint via decentralised gateway

## APIs (public)

All endpoints are GET unless noted.
- `/.netlify/functions/marketplace/listings` — Browse listings (filters: search, minPrice, maxPrice, minLength, collection, sortBy, page, limit)
- `/.netlify/functions/marketplace/listings/{name}` — Single listing detail
- `/.netlify/functions/marketplace/activity` — Recent sales + listings feed
- `/.netlify/functions/marketplace/stats` — Aggregate counts, 24h volume, floor price
- `/.netlify/functions/subgraph-proxy` (POST) — GraphQL passthrough to ENS subgraph
- `/.netlify/functions/semantic-search` (POST) — AI semantic name search
- `/.netlify/functions/ens-analytics` — Ecosystem stats
- `/.netlify/functions/discover-leaderboards` — Featured profiles and collections
- `/.netlify/functions/health` — System health + agent status

## ENS domain lifecycle (for accurate reference)

1. Active — registered and valid, no action needed
2. Expiring — within 90 days of expiry, renew to avoid grace period
3. Grace period — 90 days after expiry, original owner can renew at base price
4. Temp premium — 21 days after grace, Dutch auction with declining premium
5. Released — 111 days after expiry, anyone can register

## Contact
- Site: https://ens.tools
- X/Twitter: @enstools
- Email: hello@ens.tools
- Privacy: https://ens.tools/privacy-policy