Domain Checker MCP

An MCP (Model Context Protocol) server that checks domain availability using RDAP (Registration Data Access Protocol) with WHOIS fallback.

Features

- Check single domain availability
- Batch check multiple domains in parallel
- Prioritizes RDAP for domain lookups
- Falls back to WHOIS when RDAP is unavailable
- Configurable parallel workers (default: 4)
- Retry mechanism with exponential backoff for rate-limited responses
- Enhanced domain status detection (available, taken, unknown, rate_limited)
- Extract domain information (registrar, expiration date, days until expiration)
- Null registrationData detection for better availability accuracy
- Efficient response mode - raw RDAP/WHOIS data excluded by default for faster responses

MCP Configuration

$3

Add this server to your MCP client configuration:

``json
{
"mcpServers": {
"domain-checker": {
"command": "npx",
"args": ["-y", "domain-checker-mcp"]
}
}
}
`

$3

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

Installation

$3

`bash
npm install -g domain-checker-mcp
`

$3

`bash
git clone https://github.com/yourusername/domain-checker-mcp.git
cd domain-checker-mcp
pnpm install
pnpm build
`

Usage

$3

`bash
pnpm start
`

$3

All tools support an optional includeRawResponse parameter (boolean, default: false) to control whether raw RDAP/WHOIS data is included in responses. Raw responses are automatically included for suspicious cases (unknown status, rate limits, errors).

1. check_domain - Check if a single domain is available
- Input:
- domain (string) - The domain name to check
- includeRawResponse (boolean, optional) - Include raw response data (default: false)

2. check_domains_batch - Check multiple domains in parallel
- Input:
- domains (string[]) - Array of domain names to check
- concurrency (number, optional) - Number of parallel workers (1-10, default: 4)
- includeRawResponse (boolean, optional) - Include raw response data (default: false)

3. check_name_extensions - Check a single name with multiple extensions
- Input:
- name (string) - The domain name without extension (e.g., "example")
- extensions (string[]) - Array of extensions to check (e.g., ["com", "net", "org"])
- concurrency (number, optional) - Number of parallel workers (1-10, default: 4)
- includeRawResponse (boolean, optional) - Include raw response data (default: false)

4. check_names_extensions - Check multiple names with multiple extensions
- Input:
- names (string[]) - Array of domain names without extensions
- extensions (string[]) - Array of extensions to check for each name
- concurrency (number, optional) - Number of parallel workers (1-10, default: 4)
- includeRawResponse (boolean, optional) - Include raw response data (default: false)

$3

Single domain check returns:
`json
{
"domain": "example.com",
"available": false,
"status": "taken",
"method": "rdap",
"registrationData": { ... },
"domainInfo": {
"registrar": "Example Registrar Inc.",
"expirationDate": "2025-12-31T23:59:59Z",
"daysUntilExpiration": 365,
"creationDate": "2020-01-01T00:00:00Z",
"lastUpdated": "2024-01-15T12:00:00Z"
}
}
`

Batch check returns:
`json
{
"total": 5,
"available": 2,
"taken": 2,
"errors": 0,
"rateLimited": 1,
"unknown": 0,
"results": [...]
}
`

Name with extensions check returns:
`json
{
"name": "example",
"total": 3,
"available": 1,
"taken": 2,
"errors": 0,
"rateLimited": 0,
"unknown": 0,
"results": [...]
}
`

Multiple names with extensions returns:
`json
{
"totalNames": 2,
"totalExtensions": 3,
"totalChecks": 6,
"availableTotal": 2,
"takenTotal": 3,
"errorsTotal": 0,
"rateLimitedTotal": 1,
"unknownTotal": 0,
"resultsByName": {
"example": {
"total": 3,
"available": 1,
"taken": 2,
"errors": 0,
"rateLimited": 0,
"unknown": 0,
"domains": [...]
},
...
}
}
`

Publishing

To publish a new version:

1. Update the version in package.json
2. Commit your changes
3. Create and push a new tag:
`bash
git tag v0.1.0
git push origin v0.1.0
`
4. GitHub Actions will automatically publish to npm

$3

- Set NPM_TOKEN` secret in your GitHub repository settings
- Tag must start with 'v' (e.g., v0.1.0, v1.0.0)

License

MIT