domain-search-mcp 1.12.0 → 1.12.2

package/README.md

@@ -8,9 +8,9 @@
 [![Glama](https://img.shields.io/badge/Glama-Server-0ea5e9)](https://glama.ai/mcp/servers/@dorukardahan/domain-search-mcp)
 [![Context7](https://img.shields.io/badge/Context7-Indexed-16a34a)](https://context7.com/dorukardahan/domain-search-mcp)
 
-**Naming engine with availability intelligence** — an MCP server that scores the names your model generates and clears them against domains, socials, and package registries. Works with zero configuration using public RDAP/WHOIS, and optionally enriches results with registrar pricing via a backend you control.
+**Naming engine with availability intelligence** — an MCP server that scores the names your model generates and runs availability checks against domains, socials, and package registries. Works with zero configuration using public RDAP/WHOIS, and optionally enriches results with registrar pricing via a backend you control.
 
-**🆕 v1.12.0**: `name_project` — a two-phase naming engine. Call it once to get generation instructions for your model, call it again with `candidates[]` to get anti-slop scoring, ranking, and live availability clearance across domains, socials, and npm. See [name_project](#name_project) below.
+**🆕 v1.12.0**: `name_project` — a two-phase naming engine. Call it once to get generation instructions for your model, call it again with `candidates[]` to get anti-slop scoring, ranking, and live availability checks across domains, socials, and npm. See [name_project](#name_project) below.
 
 **🆕 v1.10.0**: GoDaddy public endpoint integration! Enhanced fallback chain (RDAP → GoDaddy → WHOIS) with premium/auction domain detection. Circuit breaker pattern ensures resilience.
 
@@ -168,24 +168,35 @@ curl -X POST https://your-domain/api/tools/search_domain \
 
 ## Tools
 
-By default only 6 tools are exposed to MCP clients (keeps tool-selection sharp):
-`name_project`, `search_domain`, `bulk_search`, `check_socials`, `tld_info`, `ai_health`.
-Set `ADVANCED_TOOLS=true` to restore the full 12-tool surface listed below (see
-[Environment Variables](#environment-variables)).
+All 12 tools listed below are exposed to MCP clients by default. The 6-tool
+slim profile (`name_project`, `search_domain`, `bulk_search`, `check_socials`,
+`tld_info`, `ai_health`) is opt-in — set `SLIM_TOOLS=true` if you want a
+sharper tool-selection surface for simpler client integrations (see
+[Environment Variables](#environment-variables)). A future 2.0 release may
+flip the default to slim.
+
+`ADVANCED_TOOLS=true` is a deprecated alias that forces the full surface and
+overrides `SLIM_TOOLS`; it's a harmless no-op today since full is already the
+default.
 
 ### name_project
 
 **Flagship two-phase naming engine.** Call it once to get lane-by-lane generation
 instructions for *your* model; call it again with `candidates[]` to get anti-slop
-scoring, ranking, and live availability clearance across domains, socials, and npm.
+scoring, ranking, and live availability checks across domains, socials, and npm.
 
 - **Modes**: `brief` (describe what you're naming), `auto` (analyze the current
   workspace), `from_name` (find domains/variants for a name you already like),
   `from_domain` (fit a project/brand to a domain you found).
 - **Phase 1** (no `candidates`): returns generation instructions + lane prompts.
-- **Phase 2** (`candidates` present): scores + ranks candidates, then clears the
-  top 12 against `targets.tlds` / `targets.platforms` — omit `targets` for pure
-  naming with no availability calls.
+- **Phase 2** (`candidates` present): scores + ranks candidates, then checks
+  availability for the top 12 against `targets.tlds` / `targets.platforms` —
+  omit `targets` for pure naming with no availability calls.
+
+> Scores are heuristic rankings for comparing candidates against each other —
+> not objective, universal brandability truth. Availability results reflect a
+> single source checked at one moment in time; re-verify before you register
+> or rely on anything.
 
 **Phase 1** — call with no `candidates`:
 ```json
@@ -210,12 +221,15 @@ Rules: single words or tight compounds, no taglines, no explanations yet. Then c
 ```
 | Name | Score | Verdict | Badges | Why |
 | --- | --- | --- | --- | --- |
-| Corda | 97 | - | - | no AI-slop patterns; clean pronunciation and typing |
-| Nexify | 60 | - | - | slop: overused prefix "nex-"; slop: overused suffix "-ify" |
+| Corda | 97 strong | - | - | no AI-slop patterns; clean pronunciation and typing |
+| Nexify | 60 middling | - | - | slop: overused prefix "nex-"; slop: overused suffix "-ify" |
 2 candidates received, 2 passed constraints, top 2 returned.
-No clearance targets - pure naming mode.
+No availability-check targets - pure naming mode.
 ```
 
+Badges: `tld✓` free to register, `tld$` for sale (aftermarket/premium - registered or priced, not free to register), `tld✗` taken, `tld?` unknown.
+ccTLD checks (`.ai` / `.io` / `.sh` / `.ac`) are cross-checked against native WHOIS/DNS ground truth, not taken on RDAP's word alone.
+
 See [docs/API.md](docs/API.md#name_project) for the full parameter/response schema.
 
 ### Core Search
@@ -324,7 +338,8 @@ QWEN_API_KEY=optional_if_secured
 | `QWEN_INFERENCE_ENDPOINT` | (none) | Your own AI inference endpoint for `suggest_domains_smart` (offline semantic fallback if unset) |
 | `QWEN_TIMEOUT_MS` | 15000 | AI inference request timeout |
 | `QWEN_MAX_RETRIES` | 2 | Retry count for AI inference failures |
-| `ADVANCED_TOOLS` | false | Set `true` to expose the full 12-tool surface instead of the slim 6-tool default |
+| `SLIM_TOOLS` | false | Set `true` to opt into the slim 6-tool surface instead of the full 12-tool default |
+| `ADVANCED_TOOLS` | false | Deprecated alias for the pre-`SLIM_TOOLS` flag. Set `true` to force the full 12-tool surface and override `SLIM_TOOLS`; no-op since full is already the default |
 
 ### Output Format