🔧 TLD presets (built-in and custom) to quickly select curated TLD sets
📏 Optional filtering by domain length
🤖 MCP server (tldx mcp) for AI agent integration
🛠️ Usage
Usage:
tldx [keywords] [flags]
tldx [command]
Available Commands:
completion Generate the autocompletion script for the specified shell
help Help about any command
mcp Start an MCP (Model Context Protocol) server over stdio
preset Manage custom TLD presets
Flags:
--dry-run Print domains that would be checked without making network calls
-f, --format string Format of output (text, json, json-stream, json-array, csv, grouped, grouped-tld) (default "text")
-h, --help help for tldx
-i, --input string File to read keywords from. Use "-" to read from stdin.
-l, --limit int Stop after finding this many available domains (0 = no limit)
-m, --max-domain-length int Maximum length of domain name (default 64)
--no-color Disable colored output
-a, --only-available Show only available domains
-p, --prefixes strings Prefixes to add (e.g. get,my,use)
-r, --regex Enable regex pattern matching for domain keywords
--show-stats Show statistics at the end of execution
-s, --suffixes strings Suffixes to add (e.g. ify,ly)
--tld-preset string Use a tld preset (e.g. popular, tech)
-t, --tlds strings TLDs to check (e.g. com,io,ai)
-v, --verbose Show verbose output
--version version for tldx
Exit code 2 is returned when --only-available is set but no available domains are found.
🔗 Examples
Domain Availability
$ tldx google
❌ google.com is not available
$ tldx google youtube reddit
❌ reddit.com is not available
❌ google.com is not available
❌ youtube.com is not available
Regex Domain Selection
Use regex patterns with the --regex flag to generate domain combinations based on patterns:
# Check all 3-letter .com domains
$ tldx '[a-z]{3}' --regex --tlds com --only-available
✔️ aaa.com is available
✔️ aab.com is available
...
# Check all 2-letter domains with specific TLDs
$ tldx '[a-z]{2}' --regex --tlds io,ai --only-available
✔️ qa.io is available
✔️ zx.ai is available
...
# Combine patterns with prefixes
$ tldx '[a-z]{2}' --regex --prefixes my,get --tlds app --only-available
✔️ myaa.app is available
✔️ getab.app is available
...
Note: Patterns generating more than 500,000 combinations will be skipped.
Presets
$ tldx google --tld-preset popular
❌ google.com is not available
❌ google.io is not available
...
$ tldx google --tld-preset geo
❌ google.au is not available
❌ google.de is not available
❌ google.us is not available
...
You can see all available presets:
$ tldx preset list
TLD Presets (* = custom):
all (use all available TLDs)
cheap pw fun icu top xyz blog info shop site click
space store online website
popular ai me app com dev net org
tech io ai gg app dev tech codes tools cloud games
software digital network security systems
data technology
...
Custom Presets
Save your own TLD presets and reuse them across runs:
# Create a preset
$ tldx preset add myteam com io ai
Saved preset "myteam" (com, io, ai) → ~/.config/tldx/presets.toml
# Comma-separated also works
$ tldx preset add myteam com,io,ai
# Use it just like any built-in preset
$ tldx mystartup --tld-preset myteam
❌ mystartup.com is not available
✔️ mystartup.io is available
✔️ mystartup.ai is available
# List all presets.
$ tldx preset list
TLD Presets (* = custom):
all (use all available TLDs)
myteam * ai io com
popular ai io app com dev net org
...
Config file: ~/.config/tldx/presets.toml
Set the TLDX_CONFIG environment variable to override the default config file location.
Permutations```sh
$ tldx google --prefixes get,my --suffixes ly,hub --tlds com,io,ai
✔️ mygooglely.com is available
✔️ getgooglely.ai is available
❌ mygoogle.ai is not available
...
### Brace Expansion (macOS, Linux)
[Brace expansion](https://www.gnu.org/software/bash/manual/html_node/Brace-Expansion.html) works out of the box in bash/zsh:
```sh
tldx {get,use}{tldx,domains} {star,fork}ongithub
✔️ gettldx.com is available
✔️ usetldx.com is available
❌ getdomains.com is not available
...
Show Only Available Domains
$ tldx google reddit facebook -p get,my -s ly,hub -t com,io,ai --only-available
✔️ getgooglely.ai is available
✔️ getreddithub.com is available
...
Limit Results
$ tldx stripe -p get,use -t com,io,ai --only-available --limit 3
✔️ getstripe.io is available
✔️ usestripe.ai is available
✔️ stripe.ai is available
