# domain-search-mcp

Checks domain availability and social handles directly from your model session. It ranks project names and flags registered addresses without browser lookups.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 28
- Author: dorukardahan
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/dorukardahan/domain-search-mcp
- Updated: 2026-10-05
- HTML: https://affpapa.org/en/nevibecode/mcp/domain-search-mcp

## What it does

The server evaluates generated names and inspects over 500 TLDs. Availability lookups run through an RDAP chain with fallback to GoDaddy and WHOIS. This sequence exposes auction signals and premium listings early. GoDaddy requests are safeguarded by a circuit breaker with a rate limit of 30 calls each minute.

The `name_project` tool provides a two-phase workflow. First, it returns generation rules for your model. Next, it accepts candidate names to filter and verify live availability. Domain suggestions run on the Qwen 7B-DPO model. By default, 12 tools are active, though `SLIM_TOOLS=true` narrows the exposed list down to 6 core functions.

Basic availability lookups require no API keys. Getting live checkout prices from Porkbun or Namecheap requires direct credentials or a dedicated backend URL. For local setups, stdio works right away, while the `--http` flag starts a server on port 3000 for ChatGPT actions or web clients.

## Requirements
- Needs: Node.js (commands run via npx)
- Environment variables: `PRICING_API_BASE_URL`, `PRICING_API_TOKEN`, `PORKBUN_API_KEY`, `PORKBUN_API_SECRET`, `NAMECHEAP_API_KEY`, `NAMECHEAP_API_USER` — keys and tokens: ask the human for the values, never commit them or put them in shared files.

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add --env PRICING_API_BASE_URL=<PRICING_API_BASE_URL> --env PRICING_API_TOKEN=<PRICING_API_TOKEN> --env PORKBUN_API_KEY=<PORKBUN_API_KEY> --env PORKBUN_API_SECRET=<PORKBUN_API_SECRET> --env NAMECHEAP_API_KEY=<NAMECHEAP_API_KEY> --transport stdio domain-search-mcp -- npx -y domain-search-mcp
```
Replace <…> with your own values. 1 more environment variable is in the server README

### Codex

**Platform CLI**
```bash
codex mcp add domain-search-mcp --env PRICING_API_BASE_URL=<PRICING_API_BASE_URL> --env PRICING_API_TOKEN=<PRICING_API_TOKEN> --env PORKBUN_API_KEY=<PORKBUN_API_KEY> --env PORKBUN_API_SECRET=<PORKBUN_API_SECRET> --env NAMECHEAP_API_KEY=<NAMECHEAP_API_KEY> -- npx -y domain-search-mcp
```
Replace <…> with your own values. 1 more environment variable is in the server README

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "domain-search-mcp": {
            "command": "npx",
            "args": [
                "-y",
                "domain-search-mcp"
            ],
            "env": {
                "PRICING_API_BASE_URL": "<PRICING_API_BASE_URL>",
                "PRICING_API_TOKEN": "<PRICING_API_TOKEN>",
                "PORKBUN_API_KEY": "<PORKBUN_API_KEY>",
                "PORKBUN_API_SECRET": "<PORKBUN_API_SECRET>",
                "NAMECHEAP_API_KEY": "<NAMECHEAP_API_KEY>"
            }
        }
    }
}
```
Replace <…> with your own values. 1 more environment variable is in the server README

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "domain-search-mcp": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "domain-search-mcp"
            ],
            "env": {
                "PRICING_API_BASE_URL": "<PRICING_API_BASE_URL>",
                "PRICING_API_TOKEN": "<PRICING_API_TOKEN>",
                "PORKBUN_API_KEY": "<PORKBUN_API_KEY>",
                "PORKBUN_API_SECRET": "<PORKBUN_API_SECRET>",
                "NAMECHEAP_API_KEY": "<NAMECHEAP_API_KEY>"
            }
        }
    }
}
```
Replace <…> with your own values. 1 more environment variable is in the server README

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add -e PRICING_API_BASE_URL=<PRICING_API_BASE_URL> -e PRICING_API_TOKEN=<PRICING_API_TOKEN> -e PORKBUN_API_KEY=<PORKBUN_API_KEY> -e PORKBUN_API_SECRET=<PORKBUN_API_SECRET> -e NAMECHEAP_API_KEY=<NAMECHEAP_API_KEY> domain-search-mcp npx -y domain-search-mcp
```
Replace <…> with your own values. 1 more environment variable is in the server README

## When to use it
- search domain availability across 500+ TLDs
- batch check up to 100 domain names simultaneously
- spot premium and aftermarket auction domains via GoDaddy
- compare registrar pricing across Porkbun and Namecheap

## Example prompts
- Check if vibecoding is available on .com, .io, and .ai.
- Run name_project to brainstorm and score brand names for a developer tool.
- Perform a bulk search for 20 project names under the .dev zone.

## Similar
- [labelhead-artist-momentum](https://affpapa.org/en/nevibecode/mcp/labelhead-artist-momentum.md) — MCP server · ★ 107423
- [openshorts](https://affpapa.org/en/nevibecode/mcp/openshorts.md) — MCP server · ★ 7049
- [OpenScreen](https://affpapa.org/en/nevibecode/mcp/openscreen.md) — MCP server · ★ 4863
- [Usertour MCP Server](https://affpapa.org/en/nevibecode/mcp/usertour-mcp-server.md) — MCP server · ★ 2326
- [Appllama](https://affpapa.org/en/nevibecode/mcp/appllama.md) — MCP server · ★ 3046
- [obsei](https://affpapa.org/en/nevibecode/mcp/obsei.md) — MCP server · ★ 1441

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md