@birdmania1/domain-mcp
v1.0.0
Published
Check domain availability across multiple registrars (GoDaddy, Namecheap) with price comparison
Maintainers
Readme
Domain MCP
Check domain availability across multiple registrars with price comparison — all from Claude
Stop tab-switching between Claude and domain registrars. Check domains conversationally, compare prices across GoDaddy and Namecheap, and get instant purchase links.
You: "Check if example.com, example.io, and example.ai are available"
Claude:
## example.com
✅ **GoDaddy** — $12.99/year — Buy on GoDaddy →
✅ **Namecheap** — $10.98/year — Buy on Namecheap →
## example.io
✅ **GoDaddy** — $39.99/year — Buy on GoDaddy →
❌ **Namecheap:** Already registered
💡 Tip: Compare prices across registrars to find the best deal!Perfect for: Startup naming · Domain research · Price comparison · Agency client work
Why Use This
Before: Brainstorm with Claude → Tab to GoDaddy → Type domain → Check → Tab to Namecheap → Check again → Back to Claude → Repeat 20 times
After: "Check if these 20 domains are available" → Instant results with price comparison → Keep brainstorming
What You Get
- Multi-registrar support — GoDaddy (recommended) + Namecheap (optional)
- Price comparison — See which registrar has the best price
- 600+ TLDs — .com, .io, .ai, .xyz, .tech, and 595 more
- No proxy server — Direct API calls, zero trust issues
- Purchase links — One-click affiliate-tracked links
- Flexible — Use one or both registrars
Quick Start
1. Get API Credentials
GoDaddy (Recommended — No IP restrictions):
- Go to https://developer.godaddy.com/keys
- Create production API key
- Copy your API Key and API Secret
Namecheap (Optional — Requires IP whitelisting):
- Enable API access in your Namecheap account
- Whitelist your IP address
- Generate API credentials
2. Configure Claude Code
Add to ~/.claude/settings.json:
GoDaddy only (simplest):
{
"mcpServers": {
"domains": {
"command": "npx",
"args": ["-y", "@birdmania1/domain-mcp"],
"env": {
"GODADDY_API_KEY": "your_api_key",
"GODADDY_API_SECRET": "your_api_secret"
}
}
}
}Both registrars (price comparison):
{
"mcpServers": {
"domains": {
"command": "npx",
"args": ["-y", "@birdmania1/domain-mcp"],
"env": {
"GODADDY_API_KEY": "your_godaddy_key",
"GODADDY_API_SECRET": "your_godaddy_secret",
"NAMECHEAP_API_USER": "your_namecheap_user",
"NAMECHEAP_API_KEY": "your_namecheap_key",
"NAMECHEAP_USERNAME": "your_namecheap_user",
"NAMECHEAP_CLIENT_IP": "your_ip_address"
}
}
}
}3. Restart Claude Code
4. Try It
Check if startup.io, myapp.com, and getapp.ai are availableClaude calls the MCP server and returns results with pricing from each registrar!
Use Cases
Startup Naming
You: "I'm building a SaaS for restaurant menus. Help me brainstorm domains."
Claude: Let me check some options...
## menusaas.com
✅ GoDaddy — $12.99/year
✅ Namecheap — $10.98/year — Buy on Namecheap → (cheaper!)
## restaurantmenu.io
✅ GoDaddy — $39.99/year
❌ Namecheap: Taken
## menu.app
❌ GoDaddy: Taken
❌ Namecheap: TakenPrice Shopping
You: "Check these 10 domains and tell me which registrar is cheapest for each"
Claude: [Checks all]
Best prices:
- example.com → Namecheap ($10.98 vs GoDaddy $12.99)
- test.io → GoDaddy ($39.99 vs Namecheap $44.88)
- myapp.ai → GoDaddy ($89.99)Domain Research
You: "Check if any single-word tech domains are available in .ai"
Claude: Checking...
compiler.ai ✅ GoDaddy $89.99
deploy.ai ✅ GoDaddy $89.99
code.ai ❌ Taken everywhereHow It Works
Architecture:
Claude MCP → GoDaddy API (direct) → Results
→ Namecheap API (direct) → Results- You ask Claude to check domains (natural language)
- Claude calls the Domain MCP tool
- MCP queries GoDaddy API (always) and Namecheap API (if configured)
- Results return with availability, pricing, and purchase links from each registrar
No proxy server. No man-in-the-middle. Your credentials stay on your machine.
Security & Trust
Why No Proxy?
Unlike some domain checkers, this MCP calls registrar APIs directly from your machine using your own API credentials.
- ✅ No proxy server to trust
- ✅ No data sent to third parties
- ✅ Open source (audit the code yourself)
- ✅ Your credentials never leave your machine
What About Purchase Links?
Purchase links include affiliate tracking to support this project. When you buy a domain via these links:
- You pay the same price (no markup)
- The registrar pays us a small commission
- You get the convenience of instant purchase links
Don't want affiliate tracking? Remove the GODADDY_AFFILIATE_ID and NAMECHEAP_AFFILIATE_ID env vars.
FAQ
Do I need accounts with both registrars?
No — you only need accounts/credentials for the registrars you want to use. GoDaddy alone works great.
Which registrar should I use?
- GoDaddy: Easier setup (no IP whitelisting), reliable API, good pricing
- Namecheap: Slightly cheaper for some TLDs, requires IP whitelist setup
- Both: Best for price comparison!
What's the difference between this and other domain MCPs?
Most domain MCPs either:
- Use a proxy server (trust issues)
- Only support one registrar
- Don't show pricing
This one is multi-registrar, direct API (no proxy), and shows price comparison.
What about rate limits?
GoDaddy: 60 requests/minute Namecheap: 20 requests/minute
Normal usage (checking dozens of domains per session) won't hit limits.
Can I add more registrars?
PRs welcome! The architecture supports adding new registrar clients easily.
Advanced Usage
Get Your Godaddy Affiliate ID
Join the GoDaddy affiliate program at https://www.godaddy.com/affiliate-programs
Add to your config:
"GODADDY_AFFILIATE_ID": "your_affiliate_id"Get Your Namecheap Affiliate ID
Apply at https://www.namecheap.com/affiliates/
Add to your config:
"NAMECHEAP_AFFILIATE_ID": "your_campaign_id"Install from Source
For development:
git clone https://github.com/ziggythebot/domain-mcp.git
cd domain-mcp
npm installThen in ~/.claude/settings.json:
{
"mcpServers": {
"domains": {
"command": "node",
"args": ["/absolute/path/to/domain-mcp/index.js"],
"env": {
"GODADDY_API_KEY": "...",
"GODADDY_API_SECRET": "..."
}
}
}
}Contributing
Found a bug? Have a feature request? PRs welcome!
Common improvements:
- Additional registrar support (Porkbun, Hover, etc.)
- Better pricing data
- Bulk domain suggestions
Credits
Built for the Claude AI and MCP community.
Uses:
License
MIT
Made by developers tired of tab-switching
⭐ Star this repo if you find it useful
