Whois Lookup

By bharathvaj-ganesan GitHub

Performs whois lookup against domain, IP, ASN and TLD.

whois-lookup domain-checker

Overview

What is Whois Lookup?

Whois Lookup is a tool that performs WHOIS lookups against domains, IP addresses, Autonomous System Numbers (ASN), and Top-Level Domains (TLD). It allows users to retrieve registration details about a domain name or IP address without needing to search through a browser.

How to use Whois Lookup?

To use Whois Lookup, you can install the MCP server using the command: npx -y @bharathvaj/whois-mcp@latest. Once installed, you can configure it in your IDE (like Cursor or Roo Code) to access WHOIS information directly through AI agents.

Key features of Whois Lookup?

Retrieve domain registration details including owner information, registration dates, and status.
Supports WHOIS lookups for domains, IPs, TLDs, and ASNs.
Integration with AI agents for seamless querying.

Use cases of Whois Lookup?

Checking if a domain is available for registration.
Finding out who owns a specific domain.
Retrieving registration and expiration dates for domains.
Analyzing domain status and associated contact information.

FAQ from Whois Lookup?

What information can I get from a WHOIS lookup?

You can retrieve details such as domain name, registrar name, registrant details, registration and expiry dates, name servers, and domain status.

Is there a limit to the number of lookups I can perform?

There may be rate limits imposed by WHOIS databases, but the tool itself does not limit the number of queries.

Can I use this tool for any domain?

Yes, you can perform lookups for any registered domain.

Content

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

Go 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

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:

The tool will be listed under Available Tools in MCP settings
Agent will automatically use it when relevant
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"
      ]
    }
  }
}

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

No tools information available.

No content found.