FastDomainCheck-MCP-Server

# FastDomainCheck MCP Server A Model Context Protocol implementation for checking domain name registration status in bulk. ## Related Links - [FastDomainCheck Online Service](https://fastdomaincheck.com/) - Check domain registration status in bulk online - [MCP Server Documentation](https://fastdomaincheck.com/fastdomaincheck-mcp-server) - Detailed project documentation and technical specifications ## Introduction FastDomainCheck MCP Server is a Model Context Protocol (MCP) server implementation that enables secure, two-way connections between AI tools (like Claude) and domain availability data. By following the open MCP standard, it ensures seamless compatibility with various AI-powered applications. ## Features - Bulk domain registration status checking - Dual verification using WHOIS and DNS - Support for IDN (Internationalized Domain Names) - Concise output format - Built-in input validation and error handling ## Tool Documentation ### check_domains Check registration status for multiple domain names. #### Input Format ```json { "domains": ["example.com", "test.com"] } ``` Parameters: - `domains`: Array of strings containing domain names to check - Maximum length of 255 characters per domain - Maximum 50 domains per request - No empty domain names allowed #### Output Format ```json { "results": { "example.com": { "registered": true }, "test.com": { "registered": false } } } ``` Response Fields: - `results`: Object with domain names as keys and check results as values - `registered`: Boolean - `true`: Domain is registered - `false`: Domain is available #### Error Handling The tool will return an error in the following cases: 1. Empty domains list 2. More than 50 domains in request 3. Empty domain name 4. Domain name exceeding 255 characters 5. Result serialization failure Error Response Format: ```json { "error": "Error: domains list cannot be empty" } ``` #### Usage Examples Check multiple domains: > Request ```json { "domains": ["example.com", "test123456.com"] } ``` > Response ```json { "results": { "example.com": { "registered": true }, "test123456.com": { "registered": false } } } ``` ## Performance Considerations 1. Domain checks are executed sequentially, taking approximately 0.3-1 second per domain 2. Maximum 50 domains per request to prevent resource exhaustion 3. WHOIS query timeout set to 10 seconds 4. DNS query fallback when WHOIS query fails ## Error Handling Strategy 1. Input Validation: Comprehensive validation before processing 2. Dual Verification: WHOIS primary, DNS fallback 3. Timeout Management: Reasonable timeouts for all network operations 4. Detailed Error Messages: Clear error descriptions for troubleshooting ## Usage ### Download Binary Download the binary file from the release page. https://github.com/bingal/FastDomainCheck-MCP-Server/releases ### For Mac/Linux ```bash chmod +x FastDomainCheck-MCP-Server ``` ### MCP Server Settings #### Configuring FastDomainCheck MCP in Claude Deskto Modify your claude-desktop-config.json file as shown below > Mac/Linux ```json { "mcpServers": { "fastdomaincheck": { "command": "/path/to/FastDomainCheck-MCP-Server", "args": [] } } } ``` > Windows ```json { "mcpServers": { "fastdomaincheck": { "command": "path/to/FastDomainCheck-MCP-Server.exe", "args": [] } } } ``` ## Python version The Python version of this project is available at [fastdomaincheck-mcp-server](https://pypi.org/project/fastdomaincheck-mcp-server/). ### MCP Server Settings ```json { "mcpServers": { "fastdomaincheck": { "command": "uvx", "args": [ "fastdomaincheck-mcp-server" ] } } } ``` ## Development Guide ### Requirements - Go 1.16 or higher - Network connectivity (for WHOIS and DNS queries) - Dependencies: - github.com/metoro-io/mcp-golang - Other project-specific dependencies ### Build ```bash # Linux go build -o FastDomainCheck-MCP-Server # Windows go build -o FastDomainCheck-MCP-Server.exe ```