Domain Checker MCP

🚀 Domain Checker MCP Server

A fast domain availability checker for Model Context Protocol (MCP), featuring DNS + RDAP/WHOIS verification.

This project is built by Brave Labs.

✨ Features

• Hybrid DNS + RDAP/WHOIS checking: Conduct a fast DNS lookup first, followed by RDAP (with WHOIS fallback) for accurate results.
• Bulk checking: Check up to 100 domains in parallel.
• Parallel processing: Use batched verification queries to achieve optimal throughput.
• Name expansion: Automatically check a base name across all popular TLDs.
• Flexible filtering: Return only available domains, only taken domains, or all results.
• Error reporting: Provide clear error handling for timeouts and failures.

📦 Installation

npm install -g @wearebravelabs/domain-checker-mcp

📚 Documentation

Configuration

Claude Desktop

Add the following to your claude_desktop_config.json:

{
  "mcpServers": {
    "domain-checker": {
      "command": "npx",
      "args": ["-y", "@wearebravelabs/domain-checker-mcp"]
    }
  }
}

Claude Code

Add the following to your MCP settings:

{
  "mcpServers": {
    "domain-checker": {
      "command": "npx",
      "args": ["-y", "@wearebravelabs/domain-checker-mcp"]
    }
  }
}

Tools

check_domains

Check specific domains for availability with full DNS + WHOIS verification.

// Check multiple domains
check_domains({
  domains: ["myapp.com", "myapp.io", "myapp.dev"]
})

// Filter to only available domains
check_domains({
  domains: ["example.com", "randomname123.com"],
  filter: "available"
})

Parameters:

• domains (required): An array of domain names to check.
• filter (optional): "available" or "taken". Omit this parameter to get all results.

check_names

Check base names across popular TLDs automatically.

// Check "myproject" across all popular TLDs
check_names({
  names: ["myproject"]
})

// Check multiple names with specific TLDs
check_names({
  names: ["startup", "launchpad"],
  tlds: ["com", "io", "co", "app"],
  filter: "available"
})

Parameters:

• names (required): An array of base names to check.
• tlds (optional): Specific TLDs to check (defaults to: com, net, org, io, co, app, dev, ai, xyz, me, info, biz, us, uk, ca, au).
• filter (optional): "available" or "taken". Omit this parameter to get all results.

check_domains_quick

Perform a fast DNS-only check without WHOIS verification. Use this when speed matters more than accuracy.

check_domains_quick({
  domains: ["example.com", "test.io"]
})

Parameters:

• domains (required): An array of domain names to check.
• filter (optional): "available" or "taken". Omit this parameter to get all results.

Note: DNS-only checks may show false positives for available domains. Use check_domains for verification.

💻 Usage Examples

Example Response

{
  "summary": {
    "total": 4,
    "available": 2,
    "taken": 2,
    "errors": 0,
    "totalTime": "634ms"
  },
  "available": [
    "myproject.io",
    "myproject.dev"
  ],
  "taken": [
    "myproject.com",
    "myproject.app"
  ]
}

With errors:

{
  "summary": {
    "total": 3,
    "available": 1,
    "taken": 1,
    "errors": 1,
    "totalTime": "10234ms"
  },
  "available": ["available-domain.com"],
  "taken": ["google.com"],
  "errors": [
    { "domain": "example.xyz", "error": "WHOIS timeout" }
  ]
}

🔧 Technical Details

1. DNS Check (Fast): All domains are checked via DNS in parallel. If DNS resolves, the domain is definitely taken.
2. RDAP/WHOIS Verification (Accurate): Domains that pass DNS (no records found) are verified via RDAP (preferred) or WHOIS (fallback) to confirm availability. RDAP servers are loaded dynamically from the IANA bootstrap registry.
3. Parallel Processing: Verification queries run in parallel batches of 20 for optimal throughput.

This hybrid approach combines the speed of DNS checking with the accuracy of RDAP/WHOIS verification.

🚧 Development

# Install dependencies
npm install

# Build
npm run build

# Run locally
npm start

More from Brave Labs

Visit bravelabs.com.au for more projects.

📄 License

This project is licensed under the MIT license © Brave Labs.