Domain Scout MCP

Domain Scout is a local-first TypeScript MCP server that helps AI agents explore product names and check domain availability across TLDs.

It is designed for naming workflows, not only exact domain lookups. Agents can:

• Check one domain.
• Check many domains at once.
• Check the same product name across multiple TLDs.
• Generate same-name, similar-name, and theme-based candidates from conversation context, then check availability.

Availability is intentionally conservative. Without a registrar API, Domain Scout reports maybe_available rather than confidently available.

Quick Start

Use it directly from NPM with npx:

npx -y domain-scout-mcp

Most MCP clients run this command for you from their config.

Claude Desktop

Add this to your Claude Desktop config:

{
  "mcpServers": {
    "domain_scout": {
      "command": "npx",
      "args": ["-y", "domain-scout-mcp"]
    }
  }
}

Then fully quit and reopen Claude Desktop.

Codex

Add this to ~/.codex/config.toml:

[mcp_servers.domain_scout]
command = "npx"
args = ["-y", "domain-scout-mcp"]

Then restart Codex.

Local Development

npm install
npm run build
npm start

For local client config while developing:

{
  "mcpServers": {
    "domain_scout": {
      "command": "node",
      "args": ["/absolute/path/to/domain-scout-mcp/dist/src/index.js"]
    }
  }
}

Tools

check_domain_availability

Checks a single exact domain with RDAP and optional DNS signals.

bulk_check_domains

Checks many exact domains with deduping, caching, and controlled concurrency.

check_name_across_tlds

Checks a name such as Bright Forge across a TLD preset or explicit TLD list.

find_domains_for_concept

Accepts explicit conversation context, seed names, themes, TLDs, and strategy. It generates candidate names/domains, checks availability, and returns a ranked shortlist.

get_tld_presets

Returns built-in TLD presets.

Example Prompts

Use Domain Scout to check whether domainscout.com is available.

Use Domain Scout to find available domains for a privacy-first AI naming assistant. Check .com, .ai, .app, and .dev.

Smoke Checks

npm run build
npm run smoke
npm run mcp:smoke

This runs live RDAP/DNS checks against a small set of domains, then verifies the compiled MCP server over stdio with an MCP client.

OpenAI LLM Smoke Check

Create .env with:

OPENAI_API_KEY=...

Then run:

npm run build
npm run llm:smoke

The script makes real OpenAI Chat Completions tool calls, routes them through the compiled MCP server over stdio, and executes live domain lookups. You can override the model:

OPENAI_MODEL=gpt-4.1-mini npm run llm:smoke

Status Semantics

• registered: Strong evidence the domain is registered.
• maybe_available: RDAP says not found and DNS has no records; confirm with a registrar before purchasing.
• available: Reserved for future registrar-backed confirmation.
• reserved: Registry or registrar says blocked/reserved.
• premium: Registrar reports premium pricing.
• invalid: The input is malformed.
• unsupported_tld: No RDAP service is known for the TLD.
• unknown: Lookup failed or signals conflict.

Privacy

Domain Scout is local-first. It does not log queries or send name ideas anywhere except the RDAP/DNS services needed to check domains.

License

MIT