# 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
```bash
# 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`:
```json
{
"mcpServers": {
"domain-checker": {
"command": "node",
"args": ["/path/to/mcp-domain-checker/dist/index.js"]
}
}
}
```
## Usage Examples
### Check Single Domain
```typescript
// Check if example.com is available
await check_domain({ domain: "example.com" })
```
### Batch Check Multiple Domains
```typescript
// Check multiple domains at once
await check_domains_batch({
domains: ["myapp.com", "myapp.io", "myapp.dev"]
})
```
### Generate Domain Suggestions
```typescript
// Get 10 domain suggestions for a tech startup
await suggest_domains({
keywords: ["tech", "startup", "ai"],
count: 10,
tlds: ["com", "io", "ai", "dev"]
})
```
## Development
```bash
# 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
