Whodis MCP Server

This project provides a Model Context Protocol (MCP) server specifically designed to check the availability of domain names using WHOIS lookups. It allows AI assistants or other tools to integrate domain availability checks into their workflows.

Overview

What is MCP?

Model Context Protocol (MCP) is an open standard that allows AI systems to securely and contextually connect with external tools and data sources. This server implements the MCP standard to provide domain availability information.

Features

Domain Availability Checks: Uses the whoiser library to perform WHOIS lookups and determine if domains appear to be available or registered.
MCP Tool Integration: Exposes a check-domain-availability tool for MCP clients (like AI assistants).
CLI Interface: Includes a command-line interface (whodis-mcp-server check-domain-availability ...) for direct usage and testing.
Structured Logging: Provides detailed logging for debugging and monitoring.
Configurable: Supports configuration via environment variables or .env files.

Getting Started

Prerequisites

Node.js (>=18.x): Download
Git: For version control

Step 1: Clone and Install

# Clone the repository
git clone https://github.com/vinsidious/whodis-mcp-server.git
cd whodis-mcp-server

# Install dependencies
npm install

Step 2: Run Development Server

Start the server in development mode to interact with it via the MCP Inspector:

npm run dev:server

This starts the MCP server and enables the MCP Inspector at http://localhost:5173, where you can test the check-domain-availability tool.

Step 3: Test the Tool via CLI

Run the domain availability checker directly from the command line:

# Using CLI in development mode
npm run dev:cli -- check-domain-availability example.com non-existent-domain-12345.org

# Or run the built version
npm run start:cli -- check-domain-availability google.com my-unique-idea.dev

The CLI will output a JSON object containing available and unavailable arrays.

Architecture

This server follows a layered architecture:

src/
├── cli/              # Command-line interface logic
├── controllers/      # Business logic for domain checks
├── services/         # Interaction with the whoiser library
├── tools/            # MCP tool definition and argument validation
├── types/            # Shared type definitions
├── utils/            # Shared utilities (logging, errors, etc.)
└── index.ts          # Main entry point for server and CLI

Development Guide

Development Scripts

# Start MCP server in development mode (with MCP Inspector)
npm run dev:server

# Run CLI commands in development mode
npm run dev:cli -- check-domain-availability <domains...>

# Build the project for production
npm run build

# Start MCP server in production mode (requires MCP client)
npm run start:server

# Run CLI commands using the production build
npm run start:cli -- check-domain-availability <domains...>

Testing

# Run all tests
npm test

# Generate test coverage report
npm run test:coverage

Code Quality

# Lint code
npm run lint

# Format code with Prettier
npm run format

MCP Tool: `check-domain-availability`

PURPOSE: Checks the availability of one or more domain names.
INPUT: An array of domain names.
{ "domains": ["example.com", "another-domain.net"] }
OUTPUT: A JSON object containing two arrays: available (domains that appear to be unregistered) and unavailable (domains that appear to be registered).
{ "available": ["likely-available-domain123.xyz"], "unavailable": ["google.com"] }
Note: Availability checks depend on WHOIS server responses and might not be 100% accurate for all TLDs or due to temporary network issues. Domains where lookup failed are omitted.
WHEN TO USE: Use this tool when you need to determine if specific domain names can potentially be registered.

Debugging

MCP Inspector

Access the visual MCP Inspector to test the tool and view request/response details:

Run npm run dev:server
Open http://localhost:5173 in your browser
Use the UI to call the check-domain-availability tool.

Server Logs

Enable debug logs for detailed output:

# Set environment variable
DEBUG=true npm run dev:server

# Or set DEBUG=true in your .env file

Logs are also saved to files in ~/.mcp/data/whodis-mcp-server.*.log.

Publishing

To publish updates to npm:

Ensure changes are committed and follow conventional commit messages (e.g., feat:, fix:, chore:).
Push changes to the main branch.
The ci-semantic-release.yml workflow will automatically build, test, version, and publish the package to npm.

License

ISC License

This server cannot be installed

security - not tested

license - not found

quality - not tested

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 enables AI assistants to check domain name availability using WHOIS lookups.

Related MCP Servers

ServiceNow MCP Server
michaelbuckner
-
security
A
license
-
quality
A 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 -
9
Python
MIT License
Whois MCP
bharathvaj-ganesan
A
security
A
license
A
quality
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.
Last updated -
4
10
1
JavaScript
MIT License
Notion MCP Server
emmanuelsystems
-
security
F
license
-
quality
A 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 -
275
JavaScript
Whois MCP
modelcontextprotocol-servers
-
security
F
license
-
quality
Enables AI agents to perform WHOIS lookups to retrieve domain registration details, including ownership, registration dates, and availability status without requiring browser searches.
Last updated -
2
2
JavaScript

View all related MCP servers

Whodis MCP Server