README.md
Reliably check domain name availability using DNS and WHOIS lookups.
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
- DNS Check: Queries DNS for A records. If found, domain is definitely taken.
- WHOIS Check: Queries WHOIS servers for registration data.
- 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
Tools (4)
check_domainCheck a single domain's availabilitycheck_alternative_tldsCheck availability across multiple TLDssuggest_domainsGenerate and check domain name variationslist_tldsList available TLD categoriesConfiguration
claude_desktop_config.json
{"mcpServers": {"domain-checker": {"command": "npx", "args": ["-y", "-p", "github:cfenzo/domain-mcp", "domain-mcp"]}}}Try it
→Check if the domain 'startup-ideas.com' is available.
→Find available variations for the domain 'mybrand' across tech-focused TLDs.
→Check if 'my-new-app' is available as a .io, .dev, or .app domain.
→List all the TLD categories supported by the domain checker.