Domain Availability Checker MCP

MCP Domain Availability Checker

Features

Domain Availability Checking
- Check availability across 50+ popular TLD extensions
- Support for popular (.com, .io, .ai), country (.us, .uk, .de), and new TLDs (.app, .dev, .tech)
- Dual verification using DNS and WHOIS for accuracy
- Smart TLD suggestions organized by popularity
Search Capabilities
- Check specific domains with exact TLD matching
- Bulk checking across supported extensions for a given name
- Parallel processing for faster domain queries
- Organized results by TLD categories
MCP Integration
- Easy setup with uvx package management
- Seamless integration with Claude Desktop
- Real-time availability status updates
- Performance metrics and timing information
AI Assistant Features
- Natural language domain queries through Claude
- Automated domain suggestion workflows
- Smart recommendations based on availability

Demo

00:00 - Checking google.com availability
Testing a well-known premium domain to demonstrate the domain checking functionality and alternative TLD suggestions.

00:20 - Testing myawesomesite.com
Verifying availability for a custom domain name and exploring alternative extension options.

00:40 - Verifying techstartup2026.io
Exploring tech startup domain options and checking availability across multiple TLD extensions.

01:00 - Analyzing aitools domain
Checking competitive AI industry domains and analyzing market availability for startup naming.

Requirements

Python 3.10 or higher
Claude Desktop
uv package manager

Dependencies Installation

Install uv package manager using one of these methods:

Official installer (recommended):

curl -LsSf https://astral.sh/uv/install.sh | sh

Homebrew (macOS/Linux):

brew install uv

Install Homebrew (if needed):

Visit https://brew.sh for installation instructions on all operating systems
Or run: /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

The MCP server automatically manages Python dependencies through uvx.

Installation

Zero-Clone Installation (Recommended)

The MCP Domain Availability Checker supports direct installation without cloning repositories, using uvx for package management.

Configuration

The Claude Desktop configuration file is located at:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json
Linux: ~/.config/Claude/claude_desktop_config.json

Edit this file to add the Domain Availability MCP configuration:

{
  "mcpServers": {
    "mcp-domain-availability": {
      "command": "uvx",
      "args": [
        "--python=3.10",
        "--from",
        "git+https://github.com/imprvhub/mcp-domain-availability",
        "mcp-domain-availability"
      ]
    }
  }
}

If you already have other MCPs configured, simply add the "mcp-domain-availability" section inside the "mcpServers" object:

{
  "mcpServers": {
    "otherMcp": {
      "command": "...",
      "args": ["..."]
    },
    "mcp-domain-availability": {
      "command": "uvx",
      "args": [
        "--python=3.10",
        "--from",
        "git+https://github.com/imprvhub/mcp-domain-availability",
        "mcp-domain-availability"
      ]
    }
  }
}

Installing via Smithery

To install mcp-domain-availability for Claude Desktop automatically via Smithery:

npx -y @smithery/cli install @imprvhub/mcp-domain-availability --client claude

Manual Installation

For development or local testing:

Clone the repository:

git clone https://github.com/imprvhub/mcp-domain-availability
cd mcp-domain-availability

Install dependencies:

uv sync

Run locally:

uv run src/mcp_domain_availability/main.py

How It Works

The MCP Domain Availability Checker uses multiple verification methods to determine domain availability:

DNS Resolution: Checks if the domain resolves to an IP address
WHOIS Lookup: Queries WHOIS databases for registration information
Socket Connection: Falls back to socket-based checking when other methods aren't available

The tool combines results from these methods to provide accurate availability status, with parallel processing for checking multiple domains simultaneously.

Available Tools

Domain Checking

Tool Name	Description	Usage
`check_domain`	Check domain availability with --domain flag	`mysite.com --domain` or `mysite --domain`

Supported TLD Categories

Popular TLDs (12)

com, net, org, io, ai, app, dev, co, xyz, me, info, biz

Country TLDs (35)

us, uk, ca, au, de, fr, it, es, nl, jp, kr, cn, in, br, mx, ar, cl, co, pe, ru, pl, cz, ch, at, se, no, dk, fi, be, pt, gr, tr, za, eg, ma, ng, ke

New TLDs

tech, online, site, website, store, shop, cloud, digital, blog, news & more.

Example Usage

Here are examples of how to use the MCP Domain Availability Checker with Claude:

Single Domain Check

Check if mysite.com is available using --domain

Domain Name Research

Check availability for "startup" across all TLDs using --domain

Specific Domain Verification

Is awesome.io available? Use --domain to check

Output Format

The tool provides comprehensive results including:

Requested Domain: Status of the exact domain queried (if specific TLD provided)
Available Domains: List of available domains sorted alphabetically
Unavailable Domains: List of registered domains
Summary Statistics: Breakdown by TLD categories (Popular, Country, New TLDs)
Performance Metrics: Check duration for each domain

Troubleshooting

"Server disconnected" error

If you see connection errors in Claude Desktop:

Verify uvx installation:
- Run uvx --version to ensure uvx is properly installed
- Reinstall uv if necessary: curl -LsSf https://astral.sh/uv/install.sh | sh
Check Python version:
- Ensure Python 3.10+ is available: python3 --version

DNS resolution issues

If domain checks are failing:

Network connectivity:
- Verify internet connection is stable
- Check if DNS servers are accessible
Rate limiting:
- Large bulk checks may hit rate limits from DNS/WHOIS services
- The tool uses a semaphore to limit concurrent requests to 20

Configuration issues

If the MCP server isn't starting:

Verify configuration syntax:
- Ensure JSON syntax is valid in claude_desktop_config.json
- Check that all brackets and quotes are properly matched
Restart Claude Desktop:
- Close and restart Claude Desktop after configuration changes

Development

Project Structure

main.py: Main entry point with MCP server and domain checking logic
Domain checking functions with DNS, WHOIS, and socket fallback methods
TLD management with categorized lists
Async processing for parallel domain checks

Building

uv build

Testing

uv run pytest

Local Development

uv run main.py

Security Considerations

The MCP Domain Availability Checker makes external network requests to DNS servers and WHOIS services. Users should be aware that:

Domain queries may be logged by DNS providers
WHOIS queries are typically logged and may be rate-limited
No personal information is transmitted beyond the domain names being checked
All queries are read-only and do not modify any external systems

Contributing

Contributions are welcome! Areas for improvement include:

Adding support for additional TLD categories
Implementing caching mechanisms for faster repeated queries
Enhancing WHOIS parsing for more detailed domain information
Improving error handling and retry mechanisms

License

This project is licensed under the Mozilla Public License 2.0 - see the LICENSE file for details.

This server cannot be installed

security - not tested

license - permissive license

quality - not tested

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.