MCP 服务器

MCP Domain Availability Server

Enables AI assistants to check domain name availability for single or multiple domains using DNS, RDAP, and WHOIS lookups. It provides detailed registration status including registrar information and expiration dates while supporting bulk checks of up to 50 domains.

README

MCP Domain Availability Server

A Model Context Protocol (MCP) server for checking domain name availability using DNS, RDAP, and WHOIS lookups. This server provides AI assistants with the ability to check if domain names are available for registration.

Features

Single Domain Checking: Check availability of individual domains
Bulk Domain Checking: Check up to 50 domains simultaneously
Multi-Protocol Lookups: Uses DNS-over-HTTPS (DoH), RDAP, and WHOIS for accurate results
Robust Error Handling: Handles timeouts, rate limits, and network errors gracefully
Security Limits: Built-in protection against abuse with request limits and timeouts

Installation

For Cursor IDE

Add the following to your ~/.cursor/mcp.json (or %APPDATA%\Cursor\mcp.json on Windows):

{
  "mcpServers": {
    "domain-availability": {
      "command": "npx",
      "args": ["-y", "mcp-domain-availability"]
    }
  }
}

Restart Cursor to activate the server.

For Other MCP Clients

The server can be used with any MCP-compatible client. Install globally:

npm install -g mcp-domain-availability

Then configure your MCP client to run:

mcp-domain-availability

Usage

Tool 1: `check_domain_availability`

Check if a single domain is available for registration.

Input:

{
  "domain": "example.com"
}

Output:

{
  "domain": "example.com",
  "available": false,
  "status": "registered",
  "registered": true,
  "details": {
    "availability": "registered",
    "registrar": "Example Registrar",
    "registrationDate": "2020-01-01",
    "expirationDate": "2025-01-01"
  }
}

Possible status values:

unregistered - Domain is available for registration
registered - Domain is already registered
unknown - Unable to determine status

Tool 2: `check_multiple_domains`

Check availability for multiple domains at once (up to 50 domains).

Input:

{
  "domains": ["example.com", "test.io", "available-domain.xyz"]
}

Output:

{
  "results": [
    {
      "domain": "example.com",
      "available": false,
      "status": "registered",
      "registered": true,
      "error": null
    },
    {
      "domain": "test.io",
      "available": true,
      "status": "unregistered",
      "registered": false,
      "error": null
    },
    {
      "domain": "available-domain.xyz",
      "available": false,
      "status": "error",
      "registered": false,
      "error": "Network error occurred",
      "errorType": "network"
    }
  ],
  "summary": {
    "total": 3,
    "available": 1,
    "registered": 1,
    "errors": 1,
    "unknown": 0
  }
}

Error Handling

The server handles various error scenarios:

Timeout Errors: Domain checks timeout after 30 seconds
Rate Limiting: Detects and reports rate limit errors from WHOIS/DNS providers
Network Errors: Handles connection failures gracefully
Invalid Input: Validates domain format and length before checking

Error Response Format

{
  "error": "Error message",
  "domain": "example.com",
  "suggestion": "Helpful suggestion for the user"
}

Requirements

Node.js >= 18.0.0
npm or compatible package manager

Limitations

Rate Limiting: WHOIS and DNS providers may rate limit requests. The server detects and reports these errors.
Timeout: Each domain check has a 30-second timeout to prevent hanging requests.
Bulk Limit: Maximum 50 domains per bulk request to prevent abuse.
TLD Support: Supports all standard TLDs. Some newer or less common TLDs may have limited information available.