domain-mcp

A CLI and MCP (Model Context Protocol) server for reliably checking domain name availability. Uses both DNS and WHOIS lookups for high-confidence results.

Features

• Dual verification: Combines DNS and WHOIS checks for reliable results
• Confidence levels: Reports high/medium/low confidence based on verification methods
• Alternative TLD search: Find available domains across multiple TLDs
• Domain suggestions: Generate variations with common prefixes/suffixes
• MCP server: Use with Claude and other MCP-compatible AI assistants
• CLI tool: Command-line interface for quick lookups

Installation

# Install globally from GitHub
npm install -g github:cfenzo/domain-mcp

# Or use directly with npx (no install needed)
npx github:cfenzo/domain-mcp --help

CLI Usage

# Check a single domain
domain-check example.com

# Check across popular TLDs
domain-check myapp --alt

# Check tech-focused TLDs (io, dev, app, ai, etc.)
domain-check startup --alt --tech

# Check specific TLDs
domain-check mybrand --tlds com,io,dev,app

# JSON output
domain-check example.com --json

# Only show available domains
domain-check myapp --alt --available-only

Or with npx (no installation):

npx -p github:cfenzo/domain-mcp domain-check example.com --alt

Claude Code MCP Server

Add to your Claude Code configuration (~/.claude.json):

{
  "mcpServers": {
    "domain-checker": {
      "command": "npx",
      "args": ["-y", "-p", "github:cfenzo/domain-mcp", "domain-mcp"]
    }
  }
}

Available MCP Tools

• check_domain: Check a single domain's availability
• check_alternative_tlds: Check availability across multiple TLDs
• suggest_domains: Generate and check domain name variations
• list_tlds: List available TLD categories

How It Works

1. DNS Check: Queries DNS for A records. If found, domain is definitely taken.
2. WHOIS Check: Queries WHOIS servers for registration data.
3. Confidence Scoring:
   • High: Both methods agree (DNS exists + WHOIS registered, or no DNS + WHOIS available)
   • Medium: Only one method provided data
   • Low: Errors or ambiguous results

TLD Categories

• General: com, net, org, io, co, dev, app, ai, xyz, me, info, biz, tech, online, site, cloud
• Tech: io, dev, app, ai, tech, cloud, software, systems, digital, code
• Country: uk, de, fr, nl, es, it, pl, ru, jp, cn, au, ca, us, in, br