Domain Finder MCP server

Domain Finder

Search and recommend good domain names to buy. Describe a product or idea; the app brainstorms brandable names (AI + rule-based combos), checks real availability via RDAP, and returns a ranked list of buy candidates.

Source-available under the Elastic License 2.0 (SPDX-License-Identifier: Elastic-2.0) — see License.

Connect to the MCP server

Domain Finder is also a remote MCP server — check a brand name across domains and the GitHub / npm / PyPI namespaces from any MCP-capable agent.

domains and the GitHub / npm / PyPI namespaces, in a single call.

• Endpoint: https://domain-finder-theta.vercel.app/api/mcp (Streamable HTTP)
• Tools:
• check_name — check whether one or more candidate names are free across

pre-checked for domain availability; feed the favorites into check_name.

• generate_names — generate candidate names from a description, each

to paste. Safe to connect.

• Read-only, and no credentials required — nothing to sign up for, no keys

salted hash of the caller IP, never the raw address) for analytics and abuse review — see SECURITY.md.

• Requests are logged. Inputs and outputs are stored server-side (with a

Cursor (~/.cursor/mcp.json) and any client with native Streamable-HTTP support:

{
  "mcpServers": {
    "domain-finder": {
      "type": "streamable-http",
      "url": "https://domain-finder-theta.vercel.app/api/mcp"
    }
  }
}

Claude Desktop (claudedesktopconfig.json) — bridge a remote server with mcp-remote:

{
  "mcpServers": {
    "domain-finder": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://domain-finder-theta.vercel.app/api/mcp"]
    }
  }
}

How it works

query ─▶ generate ─▶ check availability ─▶ rank ─▶ results
         (AI + rules)   (RDAP)              (0–100 score)

suffixes (get, try, -ly, -hq, -app, …), shorter-first.

• Generation (lib/generate.ts) — merges three sources of candidates:
• Rule-based combos: keyword extraction (stopword-filtered) × prefixes/

delicio.us, bit.ly, recip.es. Built from IANA's full TLD list; needs no API. These ignore the TLD filter by design (the word picks the zone), so they have their own toggle.

• AI brainstorm (optional): Vercel AI SDK via AI Gateway (generateObject
• zod). Degrades gracefully to rule-based when no API key is present.
• Domain hacks (lib/hacks.ts): read the word across the dot —

(round-robin so every label gets its .com before any gets a second TLD).

• Labels are deduped, capped, and expanded across the selected TLDs

AvailabilityProvider interface. Resolves each TLD to its authoritative registry RDAP server via the IANA bootstrap file (+ curated overrides), then queries the registry directly. Retries on 429.

• Availability (lib/availability.ts) — RDAP behind a swappable

on Domainr's taxonomy, each domain gets a status and a coarse bucket:

• Status taxonomy (lib/rdap-status.ts) — "taken" isn't one thing. Modelled

Shortened. The full README is on GitHub.