Spark
Sign In
MCP Connector

Query Domain and IP Registration Data

Whois MCP Server provides AI agents with tools to perform WHOIS lookups for domain, IP, and ASN details directly.

Connect
Bharathvaj
Maintainer?
91
Spark score
out of 100
Updated Mar 2025
Fresher alternatives ↓
Version 1.0.0
Models
universal
Add to Favorites

Why it matters

Leverage AI agents to perform comprehensive WHOIS queries for domains, IP addresses, ASNs, and TLDs. Retrieve essential registration information, ownership details, and other critical domain-related data.

Outcomes

What it gets done

01

Check domain availability and ownership.

02

Retrieve domain registration, expiration, and nameserver details.

03

Query WHOIS information for IP addresses and ASNs.

04

Look up details for top-level domains (TLDs).

Install

Add it to your toolbox

Run in your project directory:

curl -fsSL https://spark.entire.vc/get/vb-whois-mcp | bash

Capabilities

Tools your agent gets

whois_domain

Look up WHOIS information for a domain including ownership, registration dates, and status

whois_tld

Look up WHOIS information for a top-level domain (TLD)

whois_ip

Look up WHOIS information for an IP address

whois_as

Look up WHOIS information for an Autonomous System Number (ASN)

Overview

Whois MCP Server

This MCP server enables AI agents to perform WHOIS lookups. It provides tools to query information about domains, Top Level Domains (TLDs), IP addresses, and Autonomous System Numbers (ASNs). The server allows users to retrieve details such as domain ownership, registration and expiry dates, name servers, and domain status without needing to manually search on a browser. This server can be used by AI agents like Claude Desktop and Cursor. It can be installed globally or on a project-specific basis. For global installation, run `npx -y @bharathvaj/whois-mcp@latest`. For project-specific installation, add an `.cursor/mcp.json` file to your project with the following configuration: ```json { "mcpServers": { "whois": { "command": "npx", "args": [ "-y", "@bharathvaj/whois-mcp@latest" ] } } } ``` It can also be integrated with Roo Code by editing MCP settings.

What it does

This MCP server allows AI agents to perform WHOIS lookups and retrieve domain details. You can ask the AI to check if a domain is available, who owns it, when it was registered, and other important details.

To install this server globally, run:

npx -y @bharathvaj/whois-mcp@latest
Source README

Whois MCP

Model Context Protocol server for whois lookups.

Whois MCP server

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"
      ]
    }
  }
}
  1. 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

FAQ

Common questions

Discussion

Questions & comments · 0

Sign In Sign in to leave a comment.