Whois MCP

What is Whois-mcp?

Whois-mcp is a Model Context Protocol (MCP) server designed to allow AI agents, such as Claude Desktop, Cursor, and Windsurf, to perform WHOIS lookups. This eliminates the need for users to manually search for domain details in a browser, enabling AI to directly retrieve information about domain availability, ownership, registration dates, and other pertinent details.

How to use Whois-mcp?

Whois-mcp can be used with AI development environments like Cursor and Roo Code.

Installation - Globally (Cursor IDE):

1. Run the MCP server using npx -y @bharathvaj/whois-mcp@latest.
2. In Cursor IDE, go to Cursor Settings > MCP.
3. Click + Add New MCP Server.
4. Fill in the form with Name: Whois Lookup, Type: command, and Command: npx -y @bharathvaj/whois-mcp@latest.

Installation - Project-specific (Cursor IDE & Roo Code):

Add an .cursor/mcp.json file to your project (for Cursor) or configure in Roo Code settings:

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

Once configured, the WHOIS tools will be automatically available to the AI agent.

Key Features of Whois-mcp

Whois-mcp provides several tools for comprehensive WHOIS lookups:

• whois_domain: Looks up WHOIS information for a specific domain.
• whois_tld: Looks up WHOIS information for a Top Level Domain (TLD).
• whois_ip: Looks up WHOIS information for an IP address.
• whois_as: Looks up WHOIS information for an Autonomous System Number (ASN).

Use Cases of Whois-mcp

• Domain Availability Check: Quickly determine if a domain is available for registration.
• Domain Ownership Verification: Identify the owner of a domain, including registrant details and contact information (if not private).
• Domain Registration Details: Retrieve registration and expiry dates, registrar name, and name servers.
• AI-powered Research: Allow AI agents to gather domain-related intelligence without manual browsing.

FAQ about Whois-mcp

Q: What is a WHOIS lookup? A: A WHOIS lookup is the process of querying a WHOIS database to retrieve registration details about a domain name, IP address, or autonomous system. It helps users find out who owns a domain, when it was registered, when it expires, and other important details.

Q: What information can a WHOIS lookup provide? A: A WHOIS lookup can provide details such as: * Domain Name * Registrar Name * Registrant Details (unless protected by WHOIS privacy) * Registration & Expiry Date * Name Servers * Domain Status (Active, expired, locked, or pending deletion) * Contact Information (Administrative, technical, and billing contacts, if not hidden)

Q: How can I debug the Whois-mcp server? A: You can debug the server using the MCP Inspector. First, build the server (pnpm build), then run npx @modelcontextprotocol/inspector node dist/index.js in your terminal.

Whois MCP

Model Context Protocol server for whois lookups.

Cursor IDE Demo

https://github.com/user-attachments/assets/57a82adc-3f30-453f-aabd-7138c2e6a21d

Claude Desktop Demo

https://github.com/user-attachments/assets/d30a1f45-fdaf-4280-80f2-d5d4fc9743b1

Overview

This MCP server allows AI agents like Claude Desktop, Cursor, Windsurf,.. etc to perform WHOIS lookups and retrieve domain details.

Purpose You can directly ask the AI to check if a domain is available, who owns it, when it was registered, and other important details. No need to go to browser and search.

What is a WHOIS Lookup? A WHOIS lookup is the process of querying a WHOIS database to retrieve registration details about a domain name, IP address, or autonomous system. It helps users find out who owns a domain, when it was registered, when it expires, and other important details.

What Information Can a WHOIS Lookup Provide?

When you perform a WHOIS lookup, you can retrieve details such as:

• Domain Name – The specific domain queried
• Registrar Name – The company managing the domain registration (e.g., GoDaddy, Namecheap)
• Registrant Details – The name, organization, and contact details of the domain owner (unless protected by WHOIS privacy)
• Registration & Expiry Date – When the domain was registered and when it will expire
• Name Servers – The DNS servers the domain is using
• Domain Status – Active, expired, locked, or pending deletion
• Contact Information – Administrative, technical, and billing contacts (if not hidden)

Available Tools

Tool	Description
whois_domain	Looksup whois information about the domain
whois_tld	Looksup whois information about the Top Level Domain (TLD)
whois_ip	Looksup whois information about the IP
whois_as	Looksup whois information about the Autonomous System Number (ASN)

Using with Cursor

Installation - Globally

Run the MCP server using npx:

npx -y @bharathvaj/whois-mcp@latest

In your Cursor IDE

1. Go to Cursor Settings > MCP
2. Click + Add New MCP Server
3. Fill in the form:
   • Name: Whois Lookup (or any name you prefer)
   • Type: command
   • Command: npx -y @bharathvaj/whois-mcp@latest

Installation - Project-specific

Add an .cursor/mcp.json file to your project:

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

Usage

Once configured, the whois tools will be automatically available to the Cursor AI Agent. You can:

1. The tool will be listed under Available Tools in MCP settings
2. Agent will automatically use it when relevant
3. You can explicitly ask Agent to send notifications

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.

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

3. The whois capabilities will be available to Roo Code's AI agents

Development

# Install dependencies
pnpm install

# Build
pnpm build

Debugging the Server

To debug your server, you can use the MCP Inspector.

First build the server

pnpm build

Run the following command in your terminal:

# Start MCP Inspector and server with all tools
npx @modelcontextprotocol/inspector node dist/index.js

License

MIT