Whois Mcp

# Whois MCP

[Model Context Protocol](https://modelcontextprotocol.io) 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:

```bash 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:

```json { “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.

```json { “mcpServers”: { “whois”: { “command”: “npx”, “args”: [ “-y”, “@bharathvaj/whois-mcp@latest” ] } } } ``` 3. The whois capabilities will be available to Roo Code’s AI agents

Development

```bash

Install dependencies

pnpm install

Build

pnpm build

```

Debugging the Server

To debug your server, you can use the [MCP Inspector](https://github.com/modelcontextprotocol/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](LICENSE)