io.github.ziggythebot/namecheap

Namecheap MCP

Check domain availability across 600+ TLDs on Namecheap without leaving Claude

Ask Claude to check domains conversationally and get instant results with purchase links.

Installation

npx @birdmania1/namecheap-mcp

⚠️ IMPORTANT: After installing, you MUST configure your Namecheap API credentials (see Setup below). The MCP won't work without them.

Setup (3 minutes)

Copy-paste these commands to Claude one at a time and follow the steps:

Step 1: Get Your IP Address

Say to Claude:

Visit https://api.ipify.org and tell me my IP address

Claude will tell you your IP. Write it down - you'll need it in steps 2 and 3.

Step 2: Enable Namecheap API

Do these steps manually in your browser:

1. Go to https://www.namecheap.com and log in
2. Click Profile (top right) → Tools → Namecheap API Access
3. Click "Enable API Access"
4. Under Whitelisted IPs, click "Add New" and paste your IP from Step 1
5. Copy your API key - you'll need it in Step 3

Step 3: Configure Claude Code

Say to Claude:

Add the Namecheap MCP server to my Claude Code config with these credentials:
- API User: [your namecheap username]
- API Key: [the key you just copied]
- Username: [your namecheap username]
- Client IP: [the IP from step 1]

Use this exact MCP server config:

{
  "command": "npx",
  "args": ["-y", "@birdmania1/namecheap-mcp"],
  "env": {
    "NAMECHEAP_API_USER": "your_username",
    "NAMECHEAP_API_KEY": "your_api_key_here",
    "NAMECHEAP_USERNAME": "your_username",
    "NAMECHEAP_CLIENT_IP": "your.ip.address.here"
  }
}

Important:
1. Add it to the SAME config file where your other MCP servers are (check where perplexity/github/etc are configured)
2. Make sure "namecheap" only appears in ONE config file (not duplicated across ~/.claude.json, settings.json, or mcp.json)
3. If you get errors, check for duplicate entries and remove them

Important: Replace the placeholder values with your actual credentials before sending to Claude.

Step 4: Restart Claude Code

Fully quit Claude Code (⌘+Q on Mac, Alt+F4 on Windows) and reopen it.

Step 5: Test It

Say to Claude:

Check if example.com and startup.io are available

You should get instant results with prices and purchase links!

If it doesn't work, see Troubleshooting below.

What You Can Do

Find startup names:

"I'm building a SaaS for restaurants. Help me find a domain."

Check specific domains:

"Check if myapp.com, myapp.io, and myapp.ai are available"

Find alternatives:

"example.com is taken. Find me similar domains."

Research TLDs:

"Check if any single-word domains are available in .ai"

Features

• 600+ TLDs — .com, .io, .ai, .xyz, .tech, and more
• Batch checking — Check 100 domains at once
• Instant pricing — See costs upfront
• Purchase links — One-click to buy
• Secure — Direct API, no proxy server

Troubleshooting

"Invalid request IP" error:

• Your IP changed. Update it in Namecheap's whitelist.
• Ask Claude "What's my IP?" to get your current IP.

"API access not enabled":

• Enable it in your Namecheap account settings.

Not showing up in Claude:

• Check for duplicate entries: "namecheap" should only appear in ONE config file
• Common locations: ~/.claude.json, ~/.claude/settings.json, ~/.claude/mcp.json
• Remove duplicates, keeping only the one in the file where your other MCPs live
• Restart Claude Code after editing (full quit and reopen)
• Verify JSON is valid (no trailing commas, proper nesting)

License

MIT

Made by developers tired of tab-switching