WHOIS Lookup MCP Server

Developer ToolsTypeScript

Perform WHOIS lookups to retrieve domain, IP, and ASN information

Available Tools

whois_domain

Looks up WHOIS information about a domain

whois_tld

Looks up WHOIS information about a Top Level Domain (TLD)

whois_ip

Looks up WHOIS information about an IP address

whois_as

Looks up WHOIS information about an Autonomous System Number (ASN)

The WHOIS Lookup MCP server enables AI agents to perform WHOIS lookups directly within their workflow. It allows users to check domain availability, ownership details, registration dates, and other important information without leaving their development environment. This tool is particularly useful for developers, cybersecurity professionals, and anyone who needs to quickly verify domain or IP information.

Overview

The WHOIS Lookup MCP server provides a seamless way to perform WHOIS lookups directly through AI agents like Claude Desktop, Cursor, Windsurf, and others. This tool eliminates the need to switch to a browser for checking domain information, making your workflow more efficient.

WHOIS lookups provide valuable information about domains, IPs, and autonomous systems, including:

Domain registration and expiry dates
Registrar information
Domain owner details (when not protected by privacy)
Name servers
Domain status
Contact information

Installation

Using with Cursor IDE

Global Installation

Run the MCP server using npx:

npx -y @bharathvaj/whois-mcp@latest

In Cursor IDE:
- Navigate to Cursor Settings > MCP
- Click + Add New MCP Server
- Fill in the form:
  - Name: WHOIS Lookup (or any name you prefer)
  - Type: command
  - Command: npx -y @bharathvaj/whois-mcp@latest

Project-specific Installation

Add an .cursor/mcp.json file to your project with the following configuration:

{
  "mcpServers": {
    "whois": {
      "command": "npx",
      "args": [
        "-y",
        "@bharathvaj/whois-mcp@latest"
      ]
    }
  }
}

Using with Roo Code

Access the MCP settings by clicking "Edit MCP Settings" in Roo Code settings or using the "Roo Code: Open MCP Config" command in VS Code's command palette.
Add the following configuration:

{
  "mcpServers": {
    "whois": {
      "command": "npx",
      "args": [
        "-y",
        "@bharathvaj/whois-mcp@latest"
      ]
    }
  }
}

Using with Claude Desktop

The WHOIS Lookup MCP server is compatible with Claude Desktop. Simply install and run the server as described above, and Claude will be able to access the WHOIS lookup functionality.

Usage

Once configured, the WHOIS tools will be automatically available to your AI agent. You can:

Ask your AI to check if a domain is available
Request information about who owns a specific domain
Look up details about an IP address or ASN
Check when a domain was registered or when it expires

For example, you might ask:

"Can you check if example.com is available?"
"Who owns github.com?"
"What's the WHOIS information for the IP address 8.8.8.8?"
"When was microsoft.com registered?"

The AI agent will automatically use the appropriate WHOIS tool to retrieve the requested information.

Debugging

To debug the server, you can use the MCP Inspector:

Build the server:

pnpm build

Run the MCP Inspector:

npx @modelcontextprotocol/inspector node dist/index.js

This will allow you to inspect the requests and responses between your AI agent and the WHOIS MCP server.