# 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
```bash
# 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
```bash
# 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):
```bash
npx -p github:cfenzo/domain-mcp domain-check example.com --alt
```
## Claude Code MCP Server
Add to your Claude Code configuration (`~/.claude.json`):
```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
