The Whois MCP server allows AI agents to perform WHOIS lookups and retrieve information for:
- whois_domain: Domain lookups that provide registrar, registrant details, registration/expiry dates, name servers, domain status, and contact information
- whois_tld: Top-Level Domain lookups
- whois_ip: IP address lookups (both IPv4 and IPv6)
- whois_as: Autonomous System Number (ASN) lookups
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
- 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
- Name:
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:
- 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.
- The whois capabilities will be available to Roo Code's AI agents
Development
Debugging the Server
To debug your server, you can use the MCP Inspector.
First build the server
Run the following command in your terminal:
License
You must be authenticated.
remote-capable server
The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.
A Model Context Protocol server that allows AI agents to perform WHOIS lookups, enabling users to directly ask the AI about domain availability, ownership, registration details, and other domain information.
Related Resources
Related MCP Servers
- -securityAlicense-qualityA Model Context Protocol server enabling AI agents to access and manipulate ServiceNow data through natural language interactions, allowing users to search for records, update them, and manage scripts.Last updated -9PythonMIT License
- -securityFlicense-qualityA Model Context Protocol server that connects AI assistants like Claude to Notion workspaces, enabling them to view, search, create, and update Notion databases, pages, and content blocks.Last updated -275JavaScript
- -security-license-qualityA Model Context Protocol server that connects AI assistants to Brazilian public data services, providing access to postal codes, company registrations, bank information, area codes, IBGE data, currency exchange rates, and domain registration status.Last updated -3TypeScriptMIT License
- AsecurityFlicenseAqualityA Model Context Protocol server implementation that provides structured, AI-friendly access to eRegulations data, making it easier for AI models to answer user questions about administrative procedures.Last updated -419TypeScript