WHOIS MCP

What is WHOIS MCP?

WHOIS MCP is a Java application that provides WHOIS lookup functionality through the Model Context Protocol (MCP). It allows users to query WHOIS information for domains using a standardized interface over standard input/output, making it compatible with any MCP client.

How to use WHOIS MCP?

Build the project with Maven (mvn clean package), then configure an MCP client such as Claude Desktop or VSCode to run the JAR with java -jar PATH\\target\\whois-mcp-1.0-SNAPSHOT.jar. Once configured, the server is automatically available to any MCP client that supports the protocol.

Key features of WHOIS MCP

• Domain validation and sanitization
• Caching of WHOIS server information
• Fallback to IANA WHOIS server when specific servers are not found
• Comprehensive error handling
• Integration with the Model Context Protocol

Use cases of WHOIS MCP

• Query WHOIS information for any domain via an MCP-enabled AI assistant
• Automate domain ownership and registration lookups in developer workflows
• Integrate domain intelligence into Claude Desktop or VSCode Copilot Agent sessions

FAQ from WHOIS MCP

What runtime does WHOIS MCP require?

It requires Java 21 or higher and Maven 3.6 or higher to build.

How does WHOIS MCP determine the correct WHOIS server?

It caches WHOIS server information based on domain extensions, configured in a whois-servers.properties file. If a specific server is not found, it falls back to the IANA WHOIS server.

What dependencies does WHOIS MCP use?

It uses the Model Context Protocol SDK, SLF4J, Apache Commons Net for WHOIS client functionality, Apache Commons Validator for domain validation, and JUnit Jupiter for testing.

How do I test the WHOIS MCP server?

Run mvn test to execute the comprehensive unit tests included in the project. You can also use the MCP Inspector for debugging with a STDIO transport.

How do I debug the WHOIS MCP server?

Use the MCP Inspector by running npx @modelcontextprotocol/inspector, set transport to STDIO with command java -jar PATH\\target\\whois-mcp-1.0-SNAPSHOT.jar, and click Connect.