{"_id":"@domaindetails/whois-mcp","name":"@domaindetails/whois-mcp","dist-tags":{"latest":"1.0.0"},"versions":{"1.0.0":{"name":"@domaindetails/whois-mcp","version":"1.0.0","description":"WHOIS MCP Server - Domain registration lookup using proper WHOIS protocol (port 43). Supports 877+ TLDs with parsing for 169 ccTLDs.","mcpName":"io.github.simplebytes-com/whois-mcp","main":"build/index.js","type":"module","bin":{"whois-mcp":"build/index.js"},"scripts":{"build":"node build.js","prepare":"npm run build","start":"node build/index.js"},"keywords":["mcp","model-context-protocol","whois","whois-protocol","whois-lookup","domain","domain-lookup","domain-registration","tld","cctld","whois-parser","port-43","dns","registrar"],"author":{"name":"SimpleBytes"},"license":"MIT","repository":{"type":"git","url":"git+https://github.com/simplebytes-com/whois-mcp.git"},"homepage":"https://github.com/simplebytes-com/whois-mcp#readme","bugs":{"url":"https://github.com/simplebytes-com/whois-mcp/issues"},"dependencies":{"@modelcontextprotocol/sdk":"^0.6.0","node-fetch":"^3.3.2"},"devDependencies":{"esbuild":"^0.24.0"},"_id":"@domaindetails/whois-mcp@1.0.0","gitHead":"f727c40a080d1fe1c81ca35f4a1799ad8c6ee377","_nodeVersion":"22.20.0","_npmVersion":"10.9.3","dist":{"integrity":"sha512-Y85IuCrq6tG6MFNDOSpcFzRzFwAvcsRr8e2smDsfxYqmHd2kq338/xMDw/LRvaAuCW1dzpx2qd8MsmO5QbxZ5g==","shasum":"41d198dd2c4680cdc2c61a589a7a8c1158908847","tarball":"https://registry.npmjs.org/@domaindetails/whois-mcp/-/whois-mcp-1.0.0.tgz","fileCount":6,"unpackedSize":65394,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEYCIQCBf5cU0c9oNuDOzWfDsiRxDui2Kc9tJCax4Ks8+mbj3QIhAMtG/WIYW8Vz0TJZkpAi27TCa3n3vOZh70LW1//tP+fI"}]},"_npmUser":{"name":"simplebytes_com","email":"info@simplebytes.com"},"directories":{},"maintainers":[{"name":"simplebytes_com","email":"info@simplebytes.com"},{"name":"julianengel","email":"julian@codeero.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/whois-mcp_1.0.0_1762514638742_0.5871677853438468"},"_hasShrinkwrap":false}},"time":{"created":"2025-11-07T11:23:58.658Z","1.0.0":"2025-11-07T11:23:58.936Z","modified":"2025-11-07T11:23:59.229Z"},"maintainers":[{"name":"simplebytes_com","email":"info@simplebytes.com"},{"name":"julianengel","email":"julian@codeero.com"}],"description":"WHOIS MCP Server - Domain registration lookup using proper WHOIS protocol (port 43). Supports 877+ TLDs with parsing for 169 ccTLDs.","homepage":"https://github.com/simplebytes-com/whois-mcp#readme","keywords":["mcp","model-context-protocol","whois","whois-protocol","whois-lookup","domain","domain-lookup","domain-registration","tld","cctld","whois-parser","port-43","dns","registrar"],"repository":{"type":"git","url":"git+https://github.com/simplebytes-com/whois-mcp.git"},"author":{"name":"SimpleBytes"},"bugs":{"url":"https://github.com/simplebytes-com/whois-mcp/issues"},"license":"MIT","readme":"# WHOIS MCP Server\n\nA Model Context Protocol (MCP) server that provides comprehensive WHOIS domain lookup using the proper WHOIS protocol (TCP port 43). Queries authoritative WHOIS servers directly with support for 877+ TLDs and parsing for 169 country-code TLDs.\n\n## Features\n\n- **Native WHOIS Protocol**: Direct TCP port 43 connections to authoritative WHOIS servers\n- **877+ TLDs Supported**: Comprehensive dictionary of WHOIS servers for all major TLDs\n- **169 ccTLD Parsers**: Format-specific parsing for country-code TLDs (.gg, .pl, .jp, .kr, .ru, .de, .it, etc.)\n- **Auto-Update**: Refresh WHOIS server dictionary from IANA with built-in tool\n- **Comprehensive Parsing**: Extracts registrar, dates, nameservers, status, DNSSEC, contacts\n- **Lightweight**: Single-file executable, minimal dependencies\n- **Easy Integration**: Works with Claude Desktop and any MCP-compatible client\n\n## Installation\n\n```bash\nnpm install whois-mcp\n```\n\nOr use directly with npx:\n\n```bash\nnpx whois-mcp\n```\n\n## Usage\n\n### Option 1: Local Installation (Recommended for Claude Desktop)\n\nAdd to your Claude Desktop configuration file:\n\n**MacOS**: `~/Library/Application Support/Claude/claude_desktop_config.json`\n\n**Windows**: `%APPDATA%\\Claude\\claude_desktop_config.json`\n\n```json\n{\n  \"mcpServers\": {\n    \"whois\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"whois-mcp\"]\n    }\n  }\n}\n```\n\nRestart Claude Desktop, and you'll see the WHOIS tools in the 🔌 menu.\n\n### Option 2: Hosted Version\n\nThis server is also available as a hosted service at **mcp.domaindetails.com** for HTTP-based integrations.\n\n## Available Tools\n\n### `whois_lookup`\n\nLook up domain registration information using the proper WHOIS protocol (port 43).\n\n**Parameters:**\n- `domain` (string, required): Domain name to look up (e.g., google.com, theo.gg, mineo.pl)\n- `include_raw` (boolean, optional): Include raw WHOIS response data (default: false)\n\n**Example Request:**\n```json\n{\n  \"domain\": \"theo.gg\",\n  \"include_raw\": false\n}\n```\n\n**Example Response:**\n```json\n{\n  \"domain\": \"theo.gg\",\n  \"found\": true,\n  \"method\": \"whois\",\n  \"server\": \"whois.gg\",\n  \"timestamp\": \"2025-10-30T11:11:32.936Z\",\n  \"registrar\": \"NameCheap, Inc (https://www.namecheap.com)\",\n  \"registrant\": \"Redacted for privacy\",\n  \"creationDate\": \"2021-01-14T00:00:00Z\",\n  \"expirationDate\": \"2026-01-14T00:00:00Z\",\n  \"nameservers\": [\n    \"dns1.registrar-servers.com\",\n    \"dns2.registrar-servers.com\"\n  ],\n  \"status\": [\n    \"Active\",\n    \"Transfer Prohibited by Registrar\"\n  ],\n  \"parsed\": {\n    \"domainName\": \"theo.gg\",\n    \"registrar\": \"NameCheap, Inc (https://www.namecheap.com)\",\n    \"creationDate\": \"2021-01-14T00:00:00Z\",\n    \"expirationDate\": \"2026-01-14T00:00:00Z\",\n    \"nameservers\": [\"dns1.registrar-servers.com\", \"dns2.registrar-servers.com\"],\n    \"registrant\": \"Redacted for privacy\",\n    \"status\": [\"Active\", \"Transfer Prohibited by Registrar\"],\n    \"dnssec\": null,\n    \"lastModified\": null\n  }\n}\n```\n\n### `list_supported_tlds`\n\nList all TLDs that have WHOIS servers available for querying.\n\n**Parameters:**\n- `limit` (number, optional): Maximum number of TLDs to return (default: all)\n\n**Example Response:**\n```json\n{\n  \"totalCount\": 877,\n  \"returnedCount\": 10,\n  \"tlds\": [\n    \"aaa\",\n    \"aarp\",\n    \"abarth\",\n    \"abb\",\n    \"abbott\",\n    \"abbvie\",\n    \"abc\",\n    \"able\",\n    \"abogado\",\n    \"abudhabi\"\n  ],\n  \"timestamp\": \"2025-10-30T11:11:32.936Z\"\n}\n```\n\n### `refresh_whois_servers`\n\nRefresh the WHOIS server dictionary by fetching the latest TLD list from IANA. Run this periodically to ensure the server list is up-to-date with new TLDs.\n\n**Example Response:**\n```json\n{\n  \"success\": true,\n  \"message\": \"WHOIS server dictionary refreshed successfully\",\n  \"previousCount\": 877,\n  \"currentCount\": 880,\n  \"added\": 3,\n  \"timestamp\": \"2025-10-30T11:11:32.936Z\",\n  \"output\": \"Sync complete! Updated whois_dict.json\"\n}\n```\n\n## WHOIS Data\n\nThe server queries authoritative WHOIS servers via TCP port 43 and parses responses to extract:\n\n- **Domain Name**: Canonical domain name\n- **Registrar**: Domain registrar/registry information\n- **Registration Dates**: Creation, expiration, and last modified dates\n- **Registrant**: Domain owner information (when available, may be redacted for privacy)\n- **Admin Contact**: Administrative contact (when available)\n- **Tech Contact**: Technical contact (when available)\n- **Nameservers**: DNS nameservers for the domain\n- **Status**: Domain status codes (active, transfer prohibited, etc.)\n- **DNSSEC**: DNSSEC signing status\n\n### Supported TLDs\n\nThe server includes a comprehensive dictionary (`whois_dict.json`) with WHOIS servers for:\n\n- **Generic TLDs**: .com, .net, .org, .info, .biz, etc.\n- **Country-code TLDs**: 169 ccTLDs with format-specific parsers (.gg, .pl, .jp, .kr, .ru, .de, .it, .fr, .uk, .au, .nz, .ca, etc.)\n- **New gTLDs**: .app, .dev, .ai, .io, .me, .ly, and hundreds more\n\n### Parser Features\n\nThe included WHOIS parser supports diverse response formats:\n\n- **Standard formats**: Colon-separated key-value pairs\n- **.gg/.je style**: Natural language dates (\"30th April 2003\")\n- **.jp style**: Square bracket format `[Domain Name] GOOGLE.JP`\n- **.kr style**: Dotted dates `2007. 03. 02.`\n- **.ru style**: Cyrillic fields with IP addresses\n- **Multi-line sections**: Status blocks, nameserver lists, contact blocks\n\n## Technical Details\n\n### Architecture\n\n- **Protocol**: Native WHOIS (TCP port 43) via Node.js `net` module\n- **Parser**: Based on [whois-parser](https://github.com/simplebytes-com/whois-parser) with 169 ccTLD parsers\n- **Dictionary**: whois_dict.json with 877+ WHOIS server mappings\n- **Update Script**: fetch-iana-servers.js syncs latest TLDs from IANA\n- **Build**: Single-file executable via esbuild\n\n### Attribution\n\nThis MCP server uses the comprehensive WHOIS parser from:\n- **Repository**: https://github.com/simplebytes-com/whois-parser\n- **Author**: Simple Bytes LLC\n- **License**: MIT\n\nThe parser includes support for 169 country-code TLDs with format-specific parsing logic.\n\n## Development\n\n```bash\n# Clone repository\ngit clone https://github.com/simplebytes-com/whois-mcp.git\ncd whois-mcp\n\n# Install dependencies\nnpm install\n\n# Build\nnpm run build\n\n# Test locally\nnode build/index.js\n\n# Test with specific domains\nnode test-simple.js\n```\n\n### Build Process\n\nThe build script:\n1. Bundles source files with esbuild\n2. Adds shebang for CLI execution\n3. Copies whois_dict.json and fetch-iana-servers.js to build directory\n4. Makes the executable file\n\n### Updating the WHOIS Dictionary\n\nThe WHOIS server dictionary can be updated from IANA:\n\n```bash\ncd src\nnode fetch-iana-servers.js\n```\n\nThis fetches the latest TLD list from https://data.iana.org/TLD/tlds-alpha-by-domain.txt and updates whois_dict.json with current WHOIS servers.\n\n## Examples\n\n### Example 1: .com Domain (google.com)\n\n```json\n{\n  \"domain\": \"google.com\",\n  \"found\": true,\n  \"server\": \"whois.verisign-grs.com\",\n  \"registrar\": \"MarkMonitor Inc.\",\n  \"creationDate\": \"1997-09-15T04:00:00Z\",\n  \"expirationDate\": \"2028-09-14T04:00:00Z\",\n  \"nameservers\": [\"NS1.GOOGLE.COM\", \"NS2.GOOGLE.COM\", \"NS3.GOOGLE.COM\", \"NS4.GOOGLE.COM\"],\n  \"status\": [\"clientDeleteProhibited\", \"clientTransferProhibited\", \"clientUpdateProhibited\"],\n  \"dnssec\": \"unsigned\"\n}\n```\n\n### Example 2: .gg ccTLD (theo.gg)\n\n```json\n{\n  \"domain\": \"theo.gg\",\n  \"found\": true,\n  \"server\": \"whois.gg\",\n  \"registrar\": \"NameCheap, Inc\",\n  \"registrant\": \"Redacted for privacy\",\n  \"creationDate\": \"2021-01-14T00:00:00Z\",\n  \"expirationDate\": \"2026-01-14T00:00:00Z\",\n  \"nameservers\": [\"dns1.registrar-servers.com\", \"dns2.registrar-servers.com\"],\n  \"status\": [\"Active\", \"Transfer Prohibited by Registrar\"]\n}\n```\n\n### Example 3: .pl ccTLD (mineo.pl)\n\n```json\n{\n  \"domain\": \"mineo.pl\",\n  \"found\": true,\n  \"server\": \"whois.dns.pl\",\n  \"registrar\": \"Dynadot LLC\",\n  \"creationDate\": \"2021.02.18 23:49:54\",\n  \"expirationDate\": \"2027.02.18 23:49:54\",\n  \"nameservers\": [\"josephine.ns.cloudflare.com\", \"kenneth.ns.cloudflare.com\"],\n  \"dnssec\": \"Unsigned\",\n  \"lastModified\": \"2024.09.03 13:16:45\"\n}\n```\n\n## Troubleshooting\n\n### No WHOIS Server Found\n\nIf you get \"No WHOIS server found for TLD\", try refreshing the dictionary:\n\n```\nUse the refresh_whois_servers tool to update from IANA\n```\n\n### Connection Timeout\n\nSome WHOIS servers have rate limiting. Wait a few seconds and retry. The default timeout is 30 seconds.\n\n### Parsing Issues\n\nThe parser supports 169 ccTLDs, but some registries use unique formats. The raw WHOIS data is always available with `include_raw: true`.\n\n## License\n\nMIT\n\n## Related Projects\n\n- [domaindetails-mcp](https://github.com/simplebytes-com/domaindetails-mcp) - Full-featured domain research toolkit with RDAP, WHOIS, and DNS lookup\n- [rdap-mcp](https://github.com/simplebytes-com/rdap-mcp) - Simple RDAP-only MCP server\n- [whois-parser](https://github.com/simplebytes-com/whois-parser) - Comprehensive WHOIS parser for 169 ccTLDs\n- [DomainDetails.com](https://domaindetails.com) - Full-featured domain research SaaS\n\n## Support\n\n- **Issues**: https://github.com/simplebytes-com/whois-mcp/issues\n- **Website**: https://domaindetails.com\n- **Email**: support@domaindetails.com\n","readmeFilename":"README.md","_rev":"1-4e7163e5ee789cd296190d195a5dafcb"}