mcp-domain-availability

The MCP Domain Availability Checker is an integration that lets Claude Desktop verify domain name availability across a wide range of TLDs. It combines DNS resolution, WHOIS lookups, and socket checks to determine whether a domain is currently registered or available, and it can suggest popular alternative extensions. The server is designed to work with the uvx package manager and Claude Desktop, providing real-time status updates and timing metrics for each check. You can perform single-domain checks, bulk checks for a name across multiple TLDs, and leverage AI-assisted workflows to generate domain suggestions based on availability.

Once installed in Claude Desktop via the uvx-based configuration, you can invoke the mcp-domain-availability MCP to query domains like example.com or secure.example and receive structured results, including availability status, suggested alternatives, and verification details. The tool supports parallel processing to speed up large-domain queries and organizes results by TLD categories for easy review.

Prerequisites

• Python 3.10 or higher
• Claude Desktop installed
• uv package manager installed (uvx) or the ability to install via Smithery or manual methods

Installation options Option A: Zero-Clone installation using uvx (recommended)

1. Install uvx if you don’t have it:
   • curl -LsSf https://astral.sh/uv/install.sh | sh
   • or follow the uv installation method from the official docs
2. Add the MCP server to Claude Desktop configuration by editing the Claude config file (path varies by OS): macOS: ~/Library/Application Support/Claude/claude_desktop_config.json Windows: %APPDATA%\Claude\claude_desktop_config.json Linux: ~/.config/Claude/claude_desktop_config.json
3. Append the following to the mcpServers section:

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

4. Save the file and restart Claude Desktop. The MCP should be loaded and ready to use.

Option B: Smithery installation (automatic via Claude)

1. Run the Smithery install command:

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

2. Ensure Claude Desktop is configured to load the installed MCP as per Smithery guidance.

Option C: Manual/Development installation

1. Clone the repository and install dependencies locally:

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

2. Run locally (stdio transport by default):

uv run src/mcp_domain_availability/main.py

Docker/Cloud deployment notes (optional)

• The MCP supports transporting via sse for HTTP deployments (e.g., Google Cloud Run). If deploying, set MCP_TRANSPORT to sse in your environment and follow the Cloud Run deployment steps outlined in the repository’s docs.

Environment and configuration

• For local Claude Desktop use, no extra environment variables are required; the default transport is stdio. When deploying externally, you can enable sse via MCP_TRANSPORT=sse and configure hosting accordingly.

Tips and common considerations:

• The MCP relies on uvx to fetch and run the Git-hosted package. Ensure you have network access to the GitHub URL and that Python 3.10 is available in the uvx environment.
• If you encounter DNS or WHOIS lookup delays, check your network, firewall settings, and any corporate proxies that may block WHOIS or DNS queries.
• When deploying via Google Cloud Run or other HTTP endpoints, remember to set MCP_TRANSPORT to sse and expose port 8080 as required by the deployment script. Document any environment variables used in your deployment (e.g., API keys for ancillary services) in your layer’s configuration.
• The MCP’s results are organized by TLD and include verification details (DNS, WHOIS, socket checks). Use these fields to assess reliability and present users with suggested alternatives.
• If you update the MCP source, re-run uv sync or reinstall via Smithery to ensure the latest code is active in Claude Desktop.