domain-whois-mcp

domain-whois-mcp

Give your AI agent real-time domain intelligence. WHOIS, RDAP, availability checking, bulk lookups — all via native protocols, zero API keys.

An MCP server that lets Claude (and any MCP-compatible AI) look up domain registration data, check availability, and explore TLD infrastructure using the native WHOIS (RFC 3912) and RDAP (RFC 7482) protocols directly — no third-party APIs, no rate-limited web scrapers, no API keys.

---

Install

Claude Code — Marketplace (single command, auto-install)

This repo is its own Claude Code plugin marketplace. Add it in one step:

/plugin marketplace add kemalabuteliyte/domain-whois-mcp
/plugin install domain-whois-mcp@domain-whois-marketplace

Or in the Claude Code UI: /plugin > Browse marketplaces > Add marketplace > paste kemalabuteliyte/domain-whois-mcp > install domain-whois-mcp.

Claude Code — CLI (one command)

claude mcp add domain-whois -- npx -y github:kemalabuteliyte/domain-whois-mcp

Claude Code — UI

1. Open Claude Code
2. Go to Settings (gear icon or /settings)
3. Navigate to MCP Servers
4. Click "Add MCP Server" (or "Add Custom Server")
5. Fill in:
   • Name: domain-whois
   • Command: npx
   • Arguments: -y github:kemalabuteliyte/domain-whois-mcp
6. Click Save

The server starts automatically — all 8 tools become available immediately.

Claude Code — JSON config

You can also add it directly to your project's .mcp.json:

{
  "mcpServers": {
    "domain-whois": {
      "command": "npx",
      "args": ["-y", "github:kemalabuteliyte/domain-whois-mcp"]
    }
  }
}

Or to your user config at ~/.claude.json:

{
  "mcpServers": {
    "domain-whois": {
      "command": "npx",
      "args": ["-y", "github:kemalabuteliyte/domain-whois-mcp"]
    }
  }
}

Claude Desktop

Add to ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows):

{
  "mcpServers": {
    "domain-whois": {
      "command": "npx",
      "args": ["-y", "github:kemalabuteliyte/domain-whois-mcp"]
    }
  }
}

Restart Claude Desktop after saving.

npm (after npm publish)

npm login
npm publish
# then anyone can install with:
claude mcp add domain-whois -- npx -y domain-whois-mcp

The npm package name domain-whois-mcp is available and reserved for this project.

---

What's Inside

This is a full Claude Code plugin — not just an MCP connector. Installing it adds five surfaces:

Surface	What you get
8 MCP tools	whois_lookup, rdap_lookup, domain_check, bulk_domain_check, tld_info, whois_raw, find_whois_server, rdap_bootstrap_info
4 skills	domain-lookup (general WHOIS/RDAP), project-name-finder (brainstorm + bulk-check names), domain-monitor (expiry tracking), tld-advisor (pick the right TLD)
4 slash commands	/check-domain <domain>, /find-name <concept>, /domain-info <domain>, /tld <tld>
1 agent	domain-strategist — dedicated subagent for multi-step naming research
2 hooks	UserPromptSubmit matcher that hints about domain checks when you say "starting a new project"; PreToolUse hook that watches Bash for npm create / git init / cargo new etc. and suggests /find-name <project>

---

Finding a name for your next project

The headline workflow. Type:

/find-name ai invoicing

The project-name-finder skill (or the domain-strategist agent) will:

1. Brainstorm 15–30 candidates inspired by your concept.
2. Fan out across .com .io .dev .ai .app .co — usually 100+ lookups.
3. Run bulk_domain_check with concurrency 5.
4. Rank by .com availability, length, and multi-TLD coverage.
5. Return a top-5 table:

Rank	Name	Available on	Why it works
1	billr	.com, .io, .dev	5 chars, memorable, available on all three
2	invio	.io, .dev, .ai	short, pronounceable
...	...	...	...

You can also just ask naturally — "I'm starting an AI invoicing SaaS, help me find a name" — and the skill triggers automatically.

---

What It Does

This MCP server gives your AI agent 8 tools for complete domain name intelligence: