MCP Namecheap Server

A Model Context Protocol (MCP) server that provides tools for interacting with the Namecheap API. This server allows AI assistants to manage domains, check availability, and configure DNS records through Namecheap.

Features

• Domain Management: List domains, check availability, get domain information
• DNS Management: Get and set DNS records, configure custom nameservers
• Secure: API keys stored in environment variables
• Flexible: Supports both production and sandbox Namecheap APIs
• MCP Compatible: Works with any MCP-compatible client

Prerequisites

• Node.js 18 or higher
• Namecheap account with API access enabled
• Production API key from Namecheap (get it from https://ap.www.namecheap.com/settings/tools/apiaccess/)
• Sandbox API key for testing (register at https://www.sandbox.namecheap.com and enable API access)

Installation

From Source

1. Clone the repository:

git clone https://github.com/yourusername/mcp-namecheap.git
cd mcp-namecheap

2. Install dependencies:

npm install

3. Create a .env file from the example:

cp .env.example .env

4. Edit .env and add your Namecheap API credentials:

# Production API Key (from Namecheap account settings)
NAMECHEAP_API_KEY=your_production_api_key_here

# Sandbox API Key (from https://www.sandbox.namecheap.com)
NAMECHEAP_SANDBOX_API_KEY=your_sandbox_api_key_here

NAMECHEAP_API_USER=your_api_username_here
NAMECHEAP_CLIENT_IP=your_whitelisted_ip_here

# Set to 'true' to use sandbox API, 'false' for production
NAMECHEAP_USE_SANDBOX=true

Important: You must whitelist your IP address in the Namecheap API settings.

5. Build the project:

npm run build

Using Docker

1. Build the Docker image:

docker build -t mcp-namecheap .

2. Run with environment variables:

docker run -i \
  -e NAMECHEAP_API_KEY=your_production_api_key \
  -e NAMECHEAP_SANDBOX_API_KEY=your_sandbox_api_key \
  -e NAMECHEAP_API_USER=your_username \
  -e NAMECHEAP_CLIENT_IP=your_ip \
  -e NAMECHEAP_USE_SANDBOX=true \
  mcp-namecheap

Configuration

MCP Client Configuration

Add the server to your MCP client configuration:

For Claude Desktop

Edit ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "namecheap": {
      "command": "node",
      "args": ["/path/to/mcp-namecheap/dist/index.js"],
      "env": {
        "NAMECHEAP_API_KEY": "your_production_api_key",
        "NAMECHEAP_SANDBOX_API_KEY": "your_sandbox_api_key",
        "NAMECHEAP_API_USER": "your_username",
        "NAMECHEAP_CLIENT_IP": "your_ip",
        "NAMECHEAP_USE_SANDBOX": "true"
      }
    }
  }
}

For Smithery

The server is configured to work with Smithery installation. Simply use:

smithery install mcp-namecheap

Available Tools

Domain Management Tools

namecheap_domains_list

Lists all domains in your Namecheap account.