home / mcp / domain search mcp server

Domain Search MCP Server

Provides domain availability checks, pricing, and domain suggestions across multiple registrars via MCP

Installation

Add the following to your MCP client configuration file.

Configuration

{
  "mcpServers": {
    "dorukardahan-domain-search-mcp": {
      "command": "node",
      "args": [
        "/path/to/domain-search-mcp/dist/server.js"
      ],
      "env": {
        "DENY_TLDS": "localhost,internal",
        "LOG_LEVEL": "info",
        "ALLOWED_TLDS": "com,io,dev,app",
        "PORKBUN_API_KEY": "YOUR_API_KEY_HERE",
        "CACHE_TTL_PRICING": "3600",
        "NAMECHEAP_API_KEY": "YOUR_API_KEY_HERE",
        "NAMECHEAP_API_USER": "YOUR_USERNAME_HERE",
        "PORKBUN_API_SECRET": "YOUR_API_SECRET_HERE",
        "RATE_LIMIT_PER_MINUTE": "60",
        "CACHE_TTL_AVAILABILITY": "300"
      }
    }
  }
}

You can run the Domain Search MCP server to quickly check domain availability across registrars and TLDs, compare prices, and get smart suggestions. This server exposes a set of tools you can invoke from MCP-enabled clients to perform domain lookups, bulk searches, registrar comparisons, and social checks without writing custom integrations.”

How to use

You use the MCP server by connecting a compliant MCP client to the local or remote server and invoking its built-in tools. The core capabilities include checking domain availability across multiple TLDs with pricing, performing bulk searches, comparing registrar pricing, generating suggested domain variations, learning about TLDs, and verifying username availability on popular social platforms. Start a search from your MCP client, then review results, pricing, and recommendations to guide your next steps.

How to install

Prerequisites: you need Node.js installed on your machine. You may also run this in a container or on a host that supports MCP clients.

# 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

Configuration and running hints

To run via an MCP client, configure the MCP server entry in your client’s MCP configuration. The server is exposed as a standard MCP endpoint that the client can load and start. A typical setup uses the Node runtime to execute the compiled server file.

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

Usage from a client example

Once the MCP server is running, you can request available tools like domain search, bulk search, and social checks, and feed them with your domain data. The server handles multiple registrars and fallbacks automatically to RDAP and WHOIS when needed.

Configuration details

Environment variables help control pricing sources, caching, limits, and allowed TLDs. Create a .env file and populate the keys shown below. You can then reference these variables from the MCP server runtime.

Security and reliability

API keys, when provided, are not logged and are kept separate from standard requests. The server uses structured logging and applies rate limiting to prevent abuse. No personal data is stored or logged beyond what is necessary for domain lookup and pricing.

Troubleshooting

If you encounter rate limits or missing results, verify that your pricing sources are correctly configured and reachable. Ensure that your environment variable values are set and that your MCP client is correctly configured to connect to the server.

Development notes

The project is implemented in TypeScript. Common development commands include building the client, running tests, and starting a development server for iterative changes.

Available tools

search_domain

Check domain availability across multiple TLDs with pricing information from registrars.

bulk_search

Check many domains at once, up to a configurable limit.

compare_registrars

Compare pricing across registrars to find the best first-year and renewal rates.

suggest_domains

Generate available domain variations when your preferred name is taken.

tld_info

Provide information about a TLD, including typical use and price range.

check_socials

Verify username availability on major social platforms.