Domain Search MCP

Fast domain availability aggregator for AI assistants. Check domain availability across Porkbun, Namecheap, RDAP, and WHOIS. Compare pricing. Get suggestions.

Built with the Model Context Protocol (MCP) for seamless integration with Claude Desktop, Cursor, Cline, and other AI tools.

Get Started in 60 Seconds

1. Install

# Clone the repository
git clone https://github.com/dorukardahan/domain-search-mcp.git
cd domain-search-mcp

# Install dependencies
npm install

# Build
npm run build

2. Configure Claude Desktop

Add to your Claude Desktop configuration (~/Library/Application Support/Claude/claude_desktop_config.json on Mac):

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

3. Start Searching

Open Claude Desktop and ask:

"Check if vibecoding is available as a domain"

Claude will use the MCP server to search .com, .io, and .dev by default:

vibecoding.com - Available - $8.95/year (Porkbun)
vibecoding.io  - Available - $29.88/year (Porkbun)
vibecoding.dev - Available - $10.18/year (Porkbun)

✅ 3 domains available! Best price: vibecoding.com at $8.95/year
💡 .com is the classic, universal choice — trusted worldwide
💡 .io is popular with tech startups and SaaS products

Features

6 Powerful Tools

| Tool | What it does | |------|--------------| | search_domain | Check availability across multiple TLDs with pricing | | bulk_search | Check up to 100 domains at once | | compare_registrars | Find the best price across registrars | | suggest_domains | Get available variations when your name is taken | | tld_info | Learn about TLDs, restrictions, and typical pricing | | check_socials | Verify if usernames are available on GitHub, Twitter, Instagram |

Works Without API Keys

The server uses RDAP and WHOIS as fallbacks, so you can start using it immediately without any API keys. However, for pricing information and faster results, we recommend configuring at least Porkbun:

# Copy the example environment file
cp .env.example .env

# Edit and add your keys
nano .env

Supported Registrars

| Registrar | API Type | Pricing | Notes | |-----------|----------|---------|-------| | Porkbun | JSON | Free | Fast, includes WHOIS privacy | | Namecheap | XML | Free | Requires IP whitelist |

Fallback Protocols

| Protocol | Speed | Pricing | Authentication | |----------|-------|---------|----------------| | RDAP | Fast | No | None required | | WHOIS | Slow | No | None required |

Tool Examples

search_domain

Check if a domain is available across multiple TLDs:

// Input
{
  "domain_name": "vibecoding",
  "tlds": ["com", "io", "dev"]
}

// Output
{
  "results": [
    {
      "domain": "vibecoding.com",
      "available": true,
      "price_first_year": 8.95,
      "price_renewal": 8.95,
      "privacy_included": true,
      "registrar": "porkbun",
      "source": "porkbun_api"
    },
    // ... more results
  ],
  "insights": [
    "✅ 3 domains available! Best price: vibecoding.com at $8.95/year",
    "💡 .com is the classic, universal choice — trusted worldwide"
  ],
  "next_steps": [
    "Check social handle availability (GitHub, X, Instagram)",
    "Register vibecoding.com at porkbun to secure it"
  ]
}

bulk_search

Check many domains at once:

// Input
{
  "domains": ["vibecoding", "coolstartup", "myawesomeapp"],
  "tld": "io"
}

// Output
{
  "results": [/* array of domain results */],
  "summary": {
    "total": 3,
    "available": 2,
    "taken": 1,
    "errors": 0
  },
  "insights": [
    "✅ 2 of 3 domains available",
    "💰 Best price: vibecoding.io at $29.88/year"
  ]
}

compare_registrars

Find the best deal:

// Input
{
  "domain": "vibecoding",
  "tld": "com",
  "registrars": ["porkbun", "namecheap"]
}

// Output
{
  "domain": "vibecoding.com",
  "what_happened": "Compared pricing across 2 registrars",
  "best_first_year": { "registrar": "namecheap", "price": 8.88 },
  "best_renewal": { "registrar": "porkbun", "price": 8.95 },
  "recommendation": "Namecheap for first year ($0.07 savings), Porkbun for renewal stability"
}

suggest_domains

Get variations when your preferred name is taken:

// Input
{
  "base_name": "vibecoding",
  "tld": "com",
  "max_suggestions": 5
}

// Output
{
  "suggestions": [
    { "domain": "getvibecoding.com", "price_first_year": 8.95 },
    { "domain": "vibecodingapp.com", "price_first_year": 8.95 },
    { "domain": "tryvibecoding.com", "price_first_year": 8.95 }
  ],
  "insights": [
    "✅ Found 5 available variations",
    "⭐ Top suggestion: getvibecoding.com ($8.95/year)"
  ]
}

tld_info

Learn about a TLD:

// Input
{
  "tld": "dev"
}

// Output
{
  "tld": "dev",
  "description": "Developer - for software developers and their projects",
  "typical_use": "Developer portfolios, tools, documentation sites",
  "price_range": { "min": 10.18, "max": 19.99, "currency": "USD" },
  "restrictions": ["Requires HTTPS (HSTS preloaded)"],
  "popularity": "medium",
  "recommendation": "Ideal for developers and tech portfolios (requires HTTPS)"
}

check_socials

Verify username availability:

// Input
{
  "name": "vibecoding",
  "platforms": ["github", "twitter", "instagram"]
}

// Output
{
  "name": "vibecoding",
  "results": [
    { "platform": "github", "available": true, "confidence": "high" },
    { "platform": "twitter", "available": false, "confidence": "medium" },
    { "platform": "instagram", "available": true, "confidence": "low" }
  ],
  "insights": [
    "✅ vibecoding is available on: github",
    "❌ vibecoding is taken on: twitter",
    "⚠️ Could not reliably check: instagram (check manually)"
  ]
}

Configuration

Environment Variables

Create a .env file based on .env.example:

# Porkbun API (optional, but recommended for pricing)
# Get your free key at: https://porkbun.com/account/api
PORKBUN_API_KEY=your_api_key_here
PORKBUN_API_SECRET=your_api_secret_here

# Namecheap API (optional, requires IP whitelist)
NAMECHEAP_API_KEY=your_api_key_here
NAMECHEAP_API_USER=your_username_here

# Logging
LOG_LEVEL=info  # debug | info | warn | error

# Cache TTLs (in seconds)
CACHE_TTL_AVAILABILITY=300   # 5 minutes
CACHE_TTL_PRICING=3600       # 1 hour

# Rate limiting
RATE_LIMIT_PER_MINUTE=60

# TLD restrictions (comma-separated)
ALLOWED_TLDS=com,io,dev,app,co,net,org,xyz,ai,sh,me,cc
DENY_TLDS=localhost,internal,test,local

IDE Integration

Cursor

Add to .cursor/mcp.json:

{
  "servers": {
    "domain-search": {
      "command": "node",
      "args": ["/path/to/domain-search-mcp/dist/server.js"]
    }
  }
}

Cline

Add to your Cline settings to enable MCP servers.

Development

Setup

# Install dependencies
npm install

# Run in development mode (hot reload)
npm run dev

# Build for production
npm run build

# Run tests
npm test

# Run tests with coverage
npm run coverage

Project Structure

domain-search-mcp/
├── src/
│   ├── server.ts           # MCP server entry point
│   ├── config.ts           # Environment configuration
│   ├── types.ts            # TypeScript interfaces
│   ├── tools/              # MCP tool implementations
│   │   ├── search_domain.ts
│   │   ├── bulk_search.ts
│   │   ├── compare_registrars.ts
│   │   ├── suggest_domains.ts
│   │   ├── tld_info.ts
│   │   └── check_socials.ts
│   ├── registrars/         # Registrar adapters
│   │   ├── base.ts
│   │   ├── porkbun.ts
│   │   └── namecheap.ts
│   ├── fallbacks/          # RDAP and WHOIS fallbacks
│   │   ├── rdap.ts
│   │   └── whois.ts
│   ├── services/           # Business logic
│   │   └── domain-search.ts
│   └── utils/              # Utilities
│       ├── logger.ts
│       ├── cache.ts
│       ├── errors.ts
│       └── validators.ts
├── tests/
│   ├── unit/
│   └── integration/
├── examples/
├── package.json
├── tsconfig.json
└── README.md

Error Handling

The server provides user-friendly error messages with suggested actions:

{
  "error": true,
  "code": "RATE_LIMIT",
  "message": "Too many requests to porkbun. Please slow down.",
  "retryable": true,
  "suggestedAction": "Wait 30 seconds before trying again."
}

Error Codes

| Code | Description | Retryable | |------|-------------|-----------| | INVALID_DOMAIN | Domain name format is invalid | No | | UNSUPPORTED_TLD | TLD is not supported | No | | RATE_LIMIT | Too many requests | Yes | | AUTH_ERROR | API credentials invalid | No | | REGISTRAR_API_ERROR | Registrar API failed | Depends | | NO_SOURCE_AVAILABLE | All sources failed | Yes | | TIMEOUT | Request timed out | Yes |

Security

API keys are never logged (automatic secret masking)
Structured JSON logging for audit trails
No PII stored or logged
Rate limiting to prevent abuse

Contributing

Fork the repository
Create a feature branch: git checkout -b feature/amazing-feature
Commit your changes: git commit -m 'Add amazing feature'
Push to the branch: git push origin feature/amazing-feature
Open a Pull Request

License

MIT License - see LICENSE for details.

Links

Built with care for the vibecoding community. Magic in under 60 seconds.

MCP Servers