No description
Find a file
autocommit 6e0f60fb96
Some checks failed
Build and Publish / build-and-publish (push) Failing after 41s
deps-upgrade(deps): ⬆️ Update dependencies to latest versions for bug fixes and security improvements
Co-Authored-By: Lilith Autocommit <noreply@atlilith.com>
2026-06-11 01:21:22 -07:00
.forgejo/workflows chore(shared): 🔧 **Step 1 2026-01-15 06:54:39 -08:00
src feat(domain): Add NS record-based domain validation logic for primary availability checks 2026-05-13 15:05:03 -07:00
.gitignore Initial commit 2025-12-27 19:07:51 -08:00
eslint.config.js fix(@mcp/mcp-domain-checker): 🐛 update TypeScript rootDir import path in ESLint config 2026-01-04 20:45:33 -08:00
LICENSE Initial commit 2025-12-27 19:07:51 -08:00
package.json deps-upgrade(deps): ⬆️ Update dependencies to latest versions for bug fixes and security improvements 2026-06-11 01:21:22 -07:00
README.md chore: trigger CI publish 2026-01-30 11:56:01 -08:00
setup.sh Initial commit 2025-12-27 19:07:51 -08:00
tsconfig.json chore(shared): 🔧 Update shared configuration files and scripts 2026-01-16 20:50:10 -08:00
tsup.config.ts chore(build): Optimize tsup config with reduced minification and optimized sourcemap settings for faster builds 2026-01-21 15:30:12 -08:00

Domain Checker MCP Server

Model Context Protocol (MCP) server for domain availability checking and intelligent domain recommendations.

Purpose

Provides AI agents with domain name checking capabilities, including:

  • Check if a single domain is available for registration
  • Batch check multiple domains at once
  • Generate intelligent domain name suggestions based on keywords
  • Support for multiple TLDs (Top Level Domains)

Features

Available Tools

Tool Description
check_domain Check if a single domain name is available
check_domains_batch Check availability for multiple domains at once
suggest_domains Generate domain name suggestions based on keywords

Intelligent Features

  • WHOIS Integration: Uses the whoiser library for accurate domain availability checks
  • Multi-TLD Support: Check domains across .com, .org, .net, .io, .app, and more
  • Smart Suggestions: Generates creative domain combinations from keywords
  • Batch Processing: Efficiently check multiple domains in a single request

Installation

# Install dependencies
npm install
# or
pnpm install

# Build the server
npm run build

Configuration

No configuration required by default. The server uses public WHOIS services.

For Claude Code MCP Configuration

Add to your ~/.config/claude-code/mcp-servers.json:

{
  "mcpServers": {
    "domain-checker": {
      "command": "node",
      "args": ["/path/to/mcp-domain-checker/dist/index.js"]
    }
  }
}

Usage Examples

Check Single Domain

// Check if example.com is available
await check_domain({ domain: "example.com" })

Batch Check Multiple Domains

// Check multiple domains at once
await check_domains_batch({
  domains: ["myapp.com", "myapp.io", "myapp.dev"]
})

Generate Domain Suggestions

// Get 10 domain suggestions for a tech startup
await suggest_domains({
  keywords: ["tech", "startup", "ai"],
  count: 10,
  tlds: ["com", "io", "ai", "dev"]
})

Development

# Watch mode for development
npm run dev

# Build for production
npm run build

# Type checking
tsc --noEmit

API Reference

check_domain

Check if a single domain name is available.

Parameters:

  • domain (string, required): The domain name to check (e.g., "example.com")

Returns:

  • available (boolean): Whether the domain is available
  • domain (string): The checked domain name
  • whoisData (object, optional): Raw WHOIS data if available

check_domains_batch

Check availability for multiple domain names at once.

Parameters:

  • domains (string[], required): Array of domain names to check

Returns:

  • Array of availability results for each domain

suggest_domains

Generate domain name suggestions based on keywords.

Parameters:

  • keywords (string[], required): Keywords to use for suggestions
  • count (number, optional): Maximum number of suggestions (default: 10)
  • tlds (string[], optional): TLDs to check (default: ["com", "org", "net", "io", "app"])

Returns:

  • Array of available domain suggestions with metadata

License

MIT

Author

Built with Claude Code

Repository

https://github.com/3viky/mcp-domain-checker