bharathvaj-ganesan/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:
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:
**Usage**
Once configured, the whois tools will be automatically available to the Cursor AI Agent. You can: