Namecheap MCP Server

🚀 The Problem

Managing domain registrations typically requires navigating complex web interfaces or writing custom API integrations. This creates friction when you want to quickly check domain availability or register domains as part of your workflow.

💡 The Solution

The Namecheap MCP Server brings comprehensive domain management directly into your AI assistant. Check availability, manage your portfolio, view DNS records, and register domains using natural language - all without leaving your conversation.

You: "Show me all my domains"
Assistant: "You have 12 domains. 2 are expiring soon: myblog.com (expires in 15 days)..."

You: "Get DNS records for myblog.com"
Assistant: "myblog.com has 4 A records, 2 MX records for email..."

You: "Is mycoolstartup.com available?"
Assistant: "Yes, mycoolstartup.com is available! A .com costs $9.58/year."

You: "Register it for 2 years"
Assistant: "I'll register mycoolstartup.com for 2 years. Total: $19.16. Confirm?"

⚠️ Important Security Warning

This tool uses the Namecheap live API and can make REAL purchases. Always double-check domain registration commands before confirming.

📦 Installation

{
  "mcpServers": {
    "namecheap": {
      "command": "npx",
      "args": ["-y", "@webdevtoday/nc-mcp-server"],
      "env": {
        "NC_USERNAME": "your_namecheap_username",
        "NC_API_KEY": "your_namecheap_api_key",
        "NODE_ENV": "production"
      }
    }
  }
}

{
  "mcpServers": {
    "namecheap": {
      "uri": "https://api.smithery.ai/mcp/@webdevtoday/namecheap-domains",
      "transport": {
        "type": "sse",
        "config": {
          "apiKey": "your-smithery-api-key"
        }
      }
    }
  }
}

# Build
docker build -t nc-mcp-server .

# Run
docker run -p 3500:3500 \
  -e NC_USERNAME=your_username \
  -e NC_API_KEY=your_api_key \
  -e NODE_ENV=production \
  nc-mcp-server

🔧 Configuration

Environment Variables

Namecheap API Access

To use the Namecheap API, your account must meet one of these requirements:

• At least 20 domains in your account
• At least $50 account balance
• At least $50 spent in the last 2 years

IP Whitelisting

1. Find your IP: curl ifconfig.me
2. Log in to Namecheap
3. Go to Profile → Tools → API Access
4. Add your IP to the whitelist

Registrant Profile

{
  "env": {
    "REGISTRANT_PROFILE": "{\"firstName\":\"John\",\"lastName\":\"Doe\",\"address1\":\"123 Main St\",\"city\":\"New York\",\"stateProvince\":\"NY\",\"postalCode\":\"10001\",\"country\":\"US\",\"phone\":\"+1.2125551234\",\"email\":\"john@example.com\"}"
  }
}

{
  "firstName": "John",
  "lastName": "Doe",
  "address1": "123 Main St",
  "city": "New York",
  "stateProvince": "NY",
  "postalCode": "10001",
  "country": "US",
  "phone": "+1.2125551234",
  "email": "john@example.com"
}

🛠️ Available Tools

Domain Search & Information

check_domain

Check if a domain is available for registration.

"Is example.com available?"
"Check mydomain.io"

get_domain_list

List all domains in your Namecheap account with filtering options.

"Show me all my domains"
"List my expiring domains"
"Search for domains containing 'blog'"

get_domain_info

Get detailed information about a specific domain.

"Get info for mydomain.com"
"Show me details about example.com"

get_domain_contacts

Retrieve contact information for a domain.

"Show contacts for mydomain.com"
"Get registrant info for example.com"

Domain Management

get_tld_pricing

Get current pricing for any TLD.

"How much does a .com cost?"
"Price for .io domains"

register_domain

Register a domain with optional WhoisGuard protection.

"Register mydomain.com"
"Register example.io for 2 years"

DNS Management

get_dns_hosts

Retrieve DNS records for domains using Namecheap DNS.

"Show DNS records for mydomain.com"
"Get DNS settings for example.com"

🧪 Sandbox Mode

Test without making real purchases:

{
  "env": {
    "NODE_ENV": "sandbox",
    "NC_USERNAME": "your_username",
    "NC_API_KEY": "your_sandbox_api_key"
  }
}

🐛 Troubleshooting

🔨 Development

# Clone
git clone https://github.com/webdevtodayjason/nc-mcp-server
cd nc-mcp-server

# Install
npm install

# Build
npm run build

# Run
NC_USERNAME=your_username NC_API_KEY=your_key npm start

Deploy Your Own

To install Namecheap MCP Server for any client automatically via Smithery:

npx -y @smithery/cli@latest install @webdevtoday/namecheap-domains --client <CLIENT_NAME> --key <YOUR_SMITHERY_KEY>

You can find your Smithery key in the Smithery.ai dashboard.

🤝 Contributing

Contributions welcome! Please feel free to submit a Pull Request.

📄 License

MIT © Jason Brashear

🌟 Support

If you find this helpful, please consider:

• ⭐ Starring the repository
• 🐛 Reporting issues
• 💡 Suggesting features
• 🤝 Contributing code

Made with ❤️ by Jason Brashear