Whodis MCP Server

What is Whodis MCP Server?

Whodis MCP Server is a Model Context Protocol (MCP) server that checks the availability of domain names using WHOIS lookups. It is designed for AI assistants and other tools that need to integrate domain availability checks into their workflows.

How to use Whodis MCP Server?

Clone the repository, install dependencies with npm install, then either start the development server (npm run dev:server) and use the MCP Inspector, or run the CLI directly: npm run dev:cli -- check-domain-availability <domains...>. For production, build with npm run build and then use npm run start:server or npm run start:cli.

Features of Whodis MCP Server

• Domain availability checks using the whoiser library.
• Exposes a check-domain-availability MCP tool for clients.
• Command-line interface for direct usage and testing.
• Structured logging for debugging and monitoring.
• Configurable via environment variables or .env files.

Use cases of Whodis MCP Server

• An AI assistant checking if a proposed domain name is available before recommending registration.
• Automating batch domain availability checks for name brainstorming or portfolio management.
• Integrating domain lookup capabilities into custom MCP‑compatible tools or agents.

FAQ from Whodis MCP Server

What does the check-domain-availability tool output?

It returns a JSON object with two arrays: available (domains that appear unregistered) and unavailable (domains that appear registered). Domains where the lookup failed are omitted.

How accurate are the domain checks?

Accuracy depends on WHOIS server responses and may not be 100% reliable for all TLDs or due to temporary network issues. The server cannot guarantee correctness for every lookup.

What are the prerequisites to run this server?

Node.js (version 18.x or higher) and Git are required.

How can I test the tool locally?

Start the development server with npm run dev:server, then open the MCP Inspector at http://localhost:5173 in your browser. You can also test via the CLI using npm run dev:cli -- check-domain-availability <domains...>.

Where are logs stored?

Logs are saved to files in the ~/.mcp/data/whodis-mcp-server.*.log directory. Enable debug output by setting DEBUG=true in your environment.