Skip to content
Back to search

domain-check

Fast, universal domain availability checker - 1,200+ TLDs, pattern generation, RDAP with WHOIS fallback. CLI + Rust library + MCP server for AI agents.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/saidutt46--domain-check/badge.svg)](/listings/saidutt46--domain-check)

HTML

<a href="/listings/saidutt46--domain-check"><img src="/api/listings/saidutt46--domain-check/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

| Method | Command | Notes | |---|---|---| | Homebrew (macOS) | `brew install domain-check` | Easiest install for macOS users | | Cargo (CLI) | `cargo install domain-check` | Works on all Rust-supported platforms | | Cargo (MCP) | `cargo install domain-check-mcp` | MCP server for AI agents | | GitHub Releases | [Download binaries](https://github.com/saidutt46/domain-check/releases) | CLI + MCP binaries for macOS, Linux, Windows |

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 327 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

This file has changed since it was scanned, so this is not exactly the text that was scanned, and no line is marked. The findings are listed with the safety scan above.

  1. # domain-check
  2. Universal domain exploration engine: fast domain availability checks across the internet — as a CLI, Rust library, and MCP server for AI agents.
  3. [![Homebrew](https://img.shields.io/homebrew/v/domain-check?label=Homebrew)](https://formulae.brew.sh/formula/domain-check)
  4. [![CLI Crate](https://img.shields.io/crates/v/domain-check.svg?label=CLI)](https://crates.io/crates/domain-check)
  5. [![Library Crate](https://img.shields.io/crates/v/domain-check-lib.svg?label=Library)](https://crates.io/crates/domain-check-lib)
  6. [![MCP Server](https://img.shields.io/crates/v/domain-check-mcp.svg?label=MCP)](https://crates.io/crates/domain-check-mcp)
  7. [![Downloads](https://img.shields.io/crates/d/domain-check.svg)](https://crates.io/crates/domain-check)
  8. [![License: MIT OR Apache-2.0](https://img.shields.io/badge/License-MIT%20OR%20Apache--2.0-blue.svg)](#license)
  9. <p align="center">
  10. <img src="https://raw.githubusercontent.com/saidutt46/domain-check/main/assets/demo.svg" alt="domain-check demo" width="700"/>
  11. </p>
  12. Quick Links: [Installation](#installation) | [Quick Start](#quick-start) | [Use Cases](#use-cases) | [Output Formats](#output-formats) | [Presets](#smart-presets) | [Configuration](#configuration) | [Automation](#automation--ci) | [Library](#library) | [MCP Server](#mcp-server) | [FAQ](https://github.com/saidutt46/domain-check/blob/main/docs/FAQ.md) | [Contributing](https://github.com/saidutt46/domain-check/blob/main/CONTRIBUTING.md)
  13. ## Why domain-check
  14. - **1,200+ TLDs out of the box** — IANA bootstrap loads the full registry automatically. No config needed. 34 hardcoded TLDs work offline as fallback.
  15. - **Dual-protocol engine** — RDAP-first with automatic WHOIS fallback. IANA server discovery covers ~189 ccTLDs that lack RDAP (`.it`, `.co`, `.eu`, `.jp`). WHOIS is built in, so no system `whois` tool is needed on any platform.
  16. - **Fast** — up to 100 concurrent checks, streaming results as they complete. 3.4 MB release binary.
  17. - **Domain generation** — pattern expansion (`\w`=letter, `\d`=digit, `?`=either), prefix/suffix permutations, and `--dry-run` to preview before checking.
  18. - **11 curated presets** — `startup`, `tech`, `creative`, `finance`, `ecommerce`, and more. Or define your own in config.
  19. - **For-sale detection** — `--for-sale` reads [RFC 10023](https://www.rfc-editor.org/info/rfc10023) `_for-sale` records, so you can see when a registered domain is actually on the market (asking price and contact, sanitized, never auto-opened).
  20. - **Rich output** — grouped pretty display, JSON, CSV. Registrar info, creation/expiration dates, and status codes with `--info`.
  21. - **CI and automation friendly** — `--json`/`--csv` to stdout, `--yes` to skip prompts, `--force` for large runs, automatic non-TTY detection.
  22. - **Configurable** — TOML config files, `DC_*` environment variables, custom presets, and clear precedence rules.
  23. - **Agent-native** — MCP server exposes all tools to AI coding agents (Claude, Codex, Gemini, Cursor, VS Code Copilot, and any MCP client).
  24. - **CLI + library + MCP** — same engine powers the CLI, [`domain-check-lib`](https://crates.io/crates/domain-check-lib) (Rust library), and [`domain-check-mcp`](https://crates.io/crates/domain-check-mcp) (MCP server).
  25. ## Installation
  26. | Method | Command | Notes |
  27. |---|---|---|
  28. | Homebrew (macOS) | `brew install domain-check` | Easiest install for macOS users |
  29. | Cargo (CLI) | `cargo install domain-check` | Works on all Rust-supported platforms |
  30. | Cargo (MCP) | `cargo install domain-check-mcp` | MCP server for AI agents |
  31. | GitHub Releases | [Download binaries](https://github.com/saidutt46/domain-check/releases) | CLI + MCP binaries for macOS, Linux, Windows |
  32. ## Quick Start
  33. ```bash
  34. # Check a single domain
  35. domain-check example.com
  36. # Expand a base name across TLDs
  37. domain-check mystartup -t com,org,io,dev
  38. # Use a curated preset
  39. domain-check myapp --preset startup --pretty
  40. # Generate names with a pattern (preview only)
  41. domain-check --pattern "app\d" -t com --dry-run
  42. # Add prefixes and suffixes
  43. domain-check myapp --prefix get,try --suffix hub,ly -t com,io
  44. # Get registrar and date info
  45. domain-check target.com --info
  46. # Is a taken domain for sale? (RFC 10023)
  47. domain-check example.nl --for-sale
  48. # Check every known TLD
  49. domain-check brand --all --batch
  50. ```
  51. Pretty output:
  52. ```text
  53. domain-check v1.2.1 — Checking 8 domains
  54. Preset: startup | Concurrency: 20
  55. ── Available (3) ──────────────────────────────
  56. rustcloud.org
  57. rustcloud.ai
  58. rustcloud.app
  59. ── Taken (5) ──────────────────────────────────
  60. rustcloud.com
  61. rustcloud.io
  62. rustcloud.tech
  63. rustcloud.dev
  64. rustcloud.xyz
  65. 8 domains in 0.8s | 3 available | 5 taken | 0 unknown
  66. ```
  67. ## Use Cases
  68. ```bash
  69. # Startup naming — scan tech TLDs for your brand
  70. domain-check coolname --preset startup --pretty
  71. # Brand protection — audit every TLD for your trademark
  72. domain-check mybrand --all --json > audit.json
  73. # Pre-purchase validation — check registrar and expiry before buying
  74. domain-check target.com --info
  75. # Bulk pipeline — feed a list, export results
  76. domain-check --file ideas.txt --preset tech --csv > results.csv
  77. # Name generation — explore prefix/suffix combos
  78. domain-check app --prefix get,my,try --suffix hub,ly -t com,io --dry-run
  79. ```
  80. ## Output Formats
  81. **Default** — one line per domain, colored status:
  82. ```text
  83. myapp.com TAKEN
  84. myapp.io AVAILABLE
  85. myapp.dev TAKEN
  86. ```
  87. **Pretty** (`--pretty`) — grouped by status with summary:
  88. ```text
  89. ── Available (1) ──────────────────────────────
  90. myapp.io
  91. ── Taken (2) ──────────────────────────────────
  92. myapp.com
  93. myapp.dev
  94. 3 domains in 0.4s | 1 available | 2 taken | 0 unknown
  95. ```
  96. **JSON** (`--json`) — structured, pipe to `jq`:
  97. ```json
  98. [
  99. {
  100. "domain": "myapp.com",
  101. "available": false,
  102. "method": "RDAP"
  103. },
  104. {
  105. "domain": "myapp.io",
  106. "available": true,
  107. "method": "RDAP"
  108. }
  109. ]
  110. ```
  111. **CSV** (`--csv`) — import into spreadsheets or databases:
  112. ```text
  113. domain,status,method
  114. myapp.com,TAKEN,RDAP
  115. myapp.io,AVAILABLE,RDAP
  116. ```
  117. **Info** (`--info`) — registrar, dates, and status codes:
  118. ```text
  119. myapp.com TAKEN
  120. Registrar: Example Registrar, Inc.
  121. Created: 2015-03-12 Expires: 2026-03-12
  122. Status: clientTransferProhibited
  123. ```
  124. Full reference: [docs/CLI.md](https://github.com/saidutt46/domain-check/blob/main/docs/CLI.md)
  125. ## Smart Presets
  126. 11 built-in presets covering common domains strategies:
  127. | Preset | TLDs | Use case |
  128. |---|---|---|
  129. | `startup` | com, org, io, ai, tech, app, dev, xyz | Tech startups |
  130. | `popular` | com, net, org, io, ai, app, dev, tech, me, co, xyz | General coverage |
  131. | `classic` | com, net, org, info, biz | Traditional gTLDs |
  132. | `enterprise` | com, org, net, info, biz, us | Business and government |
  133. | `tech` | io, ai, app, dev, tech, cloud, software, + 5 more | Developer tools |
  134. | `creative` | design, art, studio, media, photography, + 5 more | Artists and media |
  135. | `ecommerce` | shop, store, market, sale, deals, + 3 more | Online retail |
  136. | `finance` | finance, capital, fund, money, investments, + 4 more | Fintech |
  137. | `web` | web, site, website, online, blog, page, + 3 more | Web services |
  138. | `trendy` | xyz, online, site, top, icu, fun, space, + 6 more | New gTLDs |
  139. | `country` | us, uk, de, fr, ca, au, br, in, nl | International |
  140. ```bash
  141. domain-check --list-presets # See all presets with full TLD lists
  142. domain-check mybrand --preset creative --pretty # Use a preset
  143. ```
  144. Define custom presets in your config file:
  145. ```toml
  146. [custom_presets]
  147. my_stack = ["com", "io", "dev", "app"]
  148. ```
  149. ## Configuration
  150. Create `domain-check.toml` in your project directory:
  151. ```toml
  152. [defaults]
  153. concurrency = 25
  154. preset = "startup"
  155. pretty = true
  156. timeout = "8s"
  157. bootstrap = true
  158. for_sale = false # set true to always check registered domains for RFC 10023 for-sale records
  159. [custom_presets]
  160. my_startup = ["com", "io", "ai", "dev", "app"]
  161. [generation]
  162. prefixes = ["get", "my"]
  163. suffixes = ["hub", "ly"]
  164. ```
  165. Config lookup order:
  166. `./domain-check.toml` > `~/.domain-check.toml` > `~/.config/domain-check/config.toml`
  167. Common environment variables:
  168. ```bash
  169. DC_CONCURRENCY=50 DC_PRESET=startup DC_TLD=com,io,dev
  170. DC_PRETTY=true DC_TIMEOUT=10s DC_BOOTSTRAP=true
  171. DC_PREFIX=get,my DC_SUFFIX=hub,ly DC_FILE=domains.txt
  172. DC_FOR_SALE=true DC_DNS_SERVER=1.1.1.1
  173. ```
  174. ## Automation & CI
  175. ```bash
  176. # Non-interactive structured output
  177. domain-check --file required-domains.txt --json
  178. # Pipe to jq
  179. domain-check --pattern "app\d" -t com --yes --json | jq '.[] | select(.available==true)'
  180. # Stream live results for long runs
  181. domain-check --file large-list.txt --concurrency 75 --streaming
  182. # Large batch with no prompts
  183. domain-check --file huge-list.txt --all --force --yes --csv > results.csv
  184. ```
  185. CI-friendly behavior:
  186. - `--yes` / `--force` skip all confirmation prompts
  187. - Non-TTY environments (piped, CI) never prompt — scripts are never blocked
  188. - Spinner writes to stderr; stdout stays clean for piping
  189. - `--no-bootstrap` for deterministic, offline-safe checks against 34 hardcoded TLDs
  190. Automation guide: [docs/AUTOMATION.md](https://github.com/saidutt46/domain-check/blob/main/docs/AUTOMATION.md)
  191. ## Library
  192. Use `domain-check-lib` directly in Rust projects:
  193. ```toml
  194. [dependencies]
  195. domain-check-lib = "1.2.1"
  196. ```
  197. ```rust
  198. use domain_check_lib::DomainChecker;
  199. #[tokio::main]
  200. async fn main() -> Result<(), Box<dyn std::error::Error>> {
  201. let checker = DomainChecker::new();
  202. let result = checker.check_domain("example.com").await?;
  203. println!("{} -> {:?}", result.domain, result.available);
  204. Ok(())
  205. }
  206. ```
  207. Library docs: [domain-check-lib/README.md](https://github.com/saidutt46/domain-check/blob/main/domain-check-lib/README.md) | [docs.rs](https://docs.rs/domain-check-lib)
  208. ## MCP Server
  209. `domain-check-mcp` exposes domain checking as tools for AI coding agents via the [Model Context Protocol](https://modelcontextprotocol.io). Works with any MCP-compatible client.
  210. ```bash
  211. # Install
  212. cargo install domain-check-mcp
  213. # Add to your agent (Claude Code example — works similarly for Codex, Gemini CLI, etc.)
  214. claude mcp add domain-check -- domain-check-mcp
  215. ```
  216. 6 tools available: `check_domain`, `check_domains`, `check_with_preset`, `generate_names`, `list_presets`, `domain_info`.
  217. Then ask your agent naturally: *"Is coolstartup.com available?"* or *"Check mybrand across the startup preset"*.
  218. The check tools take an optional `check_for_sale` parameter, and `domain_info` always includes RFC 10023 for-sale info when the holder publishes it. Responses mark that data as unverified and report failed lookups in `for_sale_errors`. Set `DC_DNS_SERVER` in the MCP client's env to choose the DNS server.
  219. Supports: Claude Code, Claude Desktop, VS Code Copilot, Cursor, Windsurf, JetBrains, OpenAI Codex CLI, Gemini CLI, and any MCP stdio client.
  220. Full setup: [domain-check-mcp/README.md](https://github.com/saidutt46/domain-check/blob/main/domain-check-mcp/README.md)
  221. ## Reliability Notes
  222. - Domain status is network- and registry-dependent. Temporary errors can produce `UNKNOWN` states.
  223. - WHOIS output is less standardized than RDAP. domain-check reads the reply formats of 40+ registries and answers `UNKNOWN` rather than guess. Some registries (`.es`, `.gr`, `.vn`, …) offer no public WHOIS, so their domains show `UNKNOWN` when RDAP can't answer.
  224. - For repeatable CI workflows, pin behavior with explicit flags (`--batch`, `--json`, `--no-bootstrap`, `--concurrency`).
  225. Troubleshooting and expected edge cases: [docs/FAQ.md](https://github.com/saidutt46/domain-check/blob/main/docs/FAQ.md)
  226. ## Project Docs
  227. - CLI reference: [docs/CLI.md](https://github.com/saidutt46/domain-check/blob/main/docs/CLI.md)
  228. - Library: [domain-check-lib/README.md](https://github.com/saidutt46/domain-check/blob/main/domain-check-lib/README.md) | [docs.rs](https://docs.rs/domain-check-lib)
  229. - MCP server: [domain-check-mcp/README.md](https://github.com/saidutt46/domain-check/blob/main/domain-check-mcp/README.md)
  230. - Examples and workflows: [docs/EXAMPLES.md](https://github.com/saidutt46/domain-check/blob/main/docs/EXAMPLES.md)
  231. - Automation usage: [docs/AUTOMATION.md](https://github.com/saidutt46/domain-check/blob/main/docs/AUTOMATION.md)
  232. - FAQ: [docs/FAQ.md](https://github.com/saidutt46/domain-check/blob/main/docs/FAQ.md)
  233. - Changelog: [CHANGELOG.md](https://github.com/saidutt46/domain-check/blob/main/CHANGELOG.md)
  234. - Contributing: [CONTRIBUTING.md](https://github.com/saidutt46/domain-check/blob/main/CONTRIBUTING.md)
  235. - Security policy: [SECURITY.md](https://github.com/saidutt46/domain-check/blob/main/SECURITY.md)
  236. ## License
  237. Licensed under either of
  238. - [Apache License, Version 2.0](https://github.com/saidutt46/domain-check/blob/main/LICENSE-APACHE)
  239. - [MIT License](https://github.com/saidutt46/domain-check/blob/main/LICENSE-MIT)
  240. at your option.

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.