tldx-mcp

tldx
tldx helps you brainstorm available domain names fast.
tldx openai -p get,use -s ly,hub -t com,io,ai --only-available
✅ getopenaily.com is available
✅ useopenaihub.io is available
...
Table of Contents
Related MCP server: domain-mcp
Features
Keyword permutations across prefixes, suffixes, and TLDs
Regex patterns for bulk combinations (e.g., all 3-letter domains)
Fast, concurrent availability checks over RDAP
Results stream as they are found
Output as
text,json,json-stream,json-array,csv,grouped, orgrouped-tldFinds taken domains advertised for sale via RFC 10023
Built-in and custom TLD presets
A config file for your usual TLDs, preset, and flags
An MCP server (
tldx mcp) for AI agents
Usage
Usage:
tldx [keywords] [flags]
tldx [command]
Available Commands:
completion Generate the autocompletion script for the specified shell
config Inspect and manage the tldx config file
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
--for-sale Check taken domains for an RFC 10023 _for-sale TXT record
-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
--only-for-sale Show only taken domains that are for sale (implies --for-sale)
-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 tldxExit 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 availableRegex Domain Selection
--regex treats each keyword as a pattern and checks every combination it expands to:
# All 3-letter .com domains
$ tldx '[a-z]{3}' --regex --tlds com --only-available
✅ aaa.com is available
✅ aab.com is available
...# All 2-letter domains on specific TLDs
$ tldx '[a-z]{2}' --regex --tlds io,ai --only-available
✅ qa.io is available
✅ zx.ai is available
...# Patterns combine with prefixes
$ tldx '[a-z]{2}' --regex --prefixes my,get --tlds app --only-available
✅ myaa.app is available
✅ getab.app is available
...Patterns that expand to more than 500,000 combinations are 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/config.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/config.toml# Remove a custom preset
$ tldx preset remove myteam
Removed preset "myteam"Defaults and Config File
Set a default preset and it applies to every run:
$ tldx preset default nordic
Default preset set to "nordic" → ~/.config/tldx/config.toml
$ tldx mystartup
✅ mystartup.se is available
✅ mystartup.nu is available
❌ mystartup.dk is not available
# Show the current default, or drop it
$ tldx preset default
Default preset: nordic
$ tldx preset default --clear
Cleared default preset (was "nordic") → ~/.config/tldx/config.tomlEverything else goes in the config file. tldx config init writes a commented
template:
[defaults]
# TLDs checked when neither --tlds nor --tld-preset is given
tlds = ["com", "se", "nu"]
# ...or a preset name instead
# tld_preset = "nordic"
prefixes = ["get", "my"]
suffixes = ["ly"]
max_domain_length = 20
format = "json"
limit = 10
only_available = true
show_stats = true
no_color = false
verbose = false
# Read RFC 10023 "_for-sale" records on taken domains.
# only_for_sale implies for_sale.
for_sale = true
only_for_sale = false
# Custom presets, usable via --tld-preset nordic
[presets.nordic]
tlds = ["se", "nu", "dk", "no", "fi"]Each key under [defaults] matches the flag of the same name, and flags passed
on the command line win. Since tlds and tld_preset both answer "which
TLDs?", passing either --tlds or --tld-preset ignores both configured
values rather than merging with them.
$ tldx config path # where the file lives
$ tldx config show # what's currently configured
$ tldx config init # write a commented template (--force to overwrite)tldx config init --force replaces the whole file, custom presets included.
The file lives at ~/.config/tldx/config.toml (macOS/Linux) or
%APPDATA%\tldx\config.toml (Windows). A presets.toml from an earlier
version still works — add a [defaults] section to it. Set TLDX_CONFIG to
use a different file.
Permutations
$ 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 works out of the box in bash/zsh:
tldx {get,use}{tldx,domains} {star,fork}ongithub
✅ gettldx.com is available
✅ usetldx.com is available
❌ getdomains.com is not available
...Domains For Sale (RFC 10023)
RFC 10023 defines a _for-sale TXT record that a domain holder can
publish to advertise that the name is for sale, optionally with an asking price and a way to get in touch.
--for-sale reads it:
$ tldx acme -t com,io --for-sale
❌ acme.io is not available
💰 acme.com is taken but for sale — USD 750 · https://fs.example.com/--only-for-sale keeps just the purchasable ones. Combine it with --only-available to see both kinds of
opportunity at once:
$ tldx acme wile coyote -t com,io --only-for-sale
$ tldx acme wile coyote -t com,io --only-available --only-for-sale--verbose also prints the free text and broker codes from the record. The lookup costs one extra DNS query
per taken domain and never runs on domains that are already available, so it stays off unless you ask for it.
A holder publishes it like this:
_for-sale.acme.com. IN TXT "v=FORSALE1;fval=USD750"
IN TXT "v=FORSALE1;furi=https://fs.example.com/"These records are written by the domain holder, so tldx treats them as untrusted: control characters are
stripped, and only http, https, mailto and tel links are shown by default. Any other scheme appears
under --verbose, flagged as unverified.
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 availableDry Run
$ tldx stripe -p get,use -t com,io --dry-run
Would check 6 domain(s):
stripe.com
stripe.io
getstripe.com
...Input from File or Stdin
$ tldx --input keywords.txt --tlds com,io --only-available
$ echo -e "stripe\natlas\nlinear" | tldx --input - --tlds com,io --only-availableOutput Formats
Output is human-readable (text) by default. Change it with --format / -f.
Color is disabled automatically when stdout is not a terminal.
JSON Array
$ tldx openai -p use -s ly -t io --format json-array
[
{ "domain": "useopenaily.io", "available": true, "keyword": "openai", "prefix": "use", "suffix": "ly", "tld": "io" },
{ "domain": "openai.io", "available": false, "keyword": "openai", "tld": "io" },
...
]With --show-stats the output is wrapped in an object:
$ tldx openai -p use -s ly -t io --format json-array --show-stats
{
"results": [ ... ],
"stats": { "total": 4, "available": 1, "not_available": 2, "errored": 1 }
}Results include keyword, prefix, suffix, and tld metadata (empty fields are omitted).
JSON Stream
$ tldx openai -p use -s ly -t io --format json-stream
{"domain":"useopenaily.io","available":true,"keyword":"openai","prefix":"use","suffix":"ly","tld":"io"}
{"domain":"openai.io","available":false,"keyword":"openai","tld":"io"}CSV
$ tldx openai -p use -s ly -t io --format csv
domain,available,keyword,prefix,suffix,tld,details,error
useopenaily.io,true,openai,use,ly,io,
openai.io,false,openai,,,io,Grouped by Keyword
$ tldx openai google -p get,use -t com,io --format grouped
google
getgoogle.com
getgoogle.io
google.com
google.io
usegoogle.com
usegoogle.io
openai
getopenai.com
...Grouped by TLD
$ tldx openai google -p get,use -t com,io --format grouped-tld
.com
getgoogle.com
getopenai.com
google.com
openai.com
usegoogle.com
useopenai.com
.io
getgoogle.io
...MCP
tldx includes an MCP server for AI agents and IDEs.
tldx mcpExample config (mcp.json / Claude Desktop / VS Code):
{
"mcpServers": {
"tldx": {
"command": "tldx",
"args": ["mcp"]
}
}
}Two tools, both read-only and returning the same result shape:
Tool | Use it when |
| You already know the exact names to test. |
| You want names built from keywords, prefixes, suffixes, and TLDs. |
Your custom presets and [defaults] from the config file apply here just as they
do on the command line. generate_and_check advertises every preset name in its tld_preset schema, so no
separate lookup call is needed.
Result shape
Each result carries a status of available, taken, or unknown. unknown means the lookup failed, not
that the domain is free, and the available field is omitted entirely in that case.
Each response also reports checked, available_count, taken_count, and — when the search stopped early —
truncated: true plus a note explaining what to change.
Call budget
One call resolves at most 1000 domains, and generate_and_check is rejected above that before any lookup
happens, naming the argument to shrink. Two ways to search a larger space:
only_available: truewithlimit: Nstops the sweep once N available domains are found, which makes a wide search cheap. This is usually what you want.dry_run: truereturns the exact domain list and count with no network requests, so an agent can price a call before making it, or see which TLDs a preset expands to.
Collection also stops at 45 seconds, under the typical client timeout, returning partial results marked
truncated rather than failing outright.
Domains for sale
Both tools accept check_for_sale: true, which adds a for_sale object to any taken domain that advertises
itself for sale, and only_for_sale: true to return just those. See
Domains For Sale.
Installation
macOS (Homebrew)
brew install tldxor
brew tap brandonyoungdev/tldx
brew install tldxWindows (winget)
winget install --id=brandonyoungdev.tldx -eArch Linux (AUR)
Two options are available for Arch Linux users:
Linux and Windows (Manual)
Visit the Releases page.
Download the archive for your OS and architecture:
macOS / Linux:
tldx_<version>_<os>_<arch>.tar.gzWindows:
tldx_<version>_windows_<arch>.zip
tar -xzf tldx_<version>_<os>_<arch>.tar.gz
mv tldx /usr/local/bin/Go (Install from Source)
go install github.com/brandonyoungdev/tldx@latestThis server cannot be installed
Maintenance
Resources
Unclaimed servers have limited discoverability.
Looking for Admin?
If you are the server author, to access and configure the admin panel.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceA simple MCP server that enables AI assistants to perform domain research including availability checking, WHOIS lookups, DNS record retrieval, and finding expired domains without requiring API keys.62MIT
- FlicenseNot gradedqualityNot gradedmaintenanceAn MCP server for domain availability checks, WHOIS lookups, and domain suggestions using RDAP and TCP port 43. It allows users to perform bulk checks and retrieve registration details across multiple TLDs without requiring an API key.51
- AlicenseNot gradedqualityDmaintenanceMCP server for domainagent.dev, enabling AI agents to search, register, deploy, host, and manage domains with USDC payment on Base via x402. Supports static site deployment via Cloudflare Pages and DNS management.16MIT
- AlicenseNot gradedqualityBmaintenanceMCP server for domain portfolio management, registrar operations, marketplace, and DNS management via CLI or AI agents.1,0851Apache 2.0
Related MCP Connectors
MCP server for AI agents to plan, verify, and deploy Cloudflare-native apps.
Domain search MCP: .com names verified available live via Verisign RDAP - not AI guess lists
Domain search, registration, DNS, marketplace, and checkout with your AI agent.
Latest Blog Posts
- Who's Calling? MCP Hosts Are an Identity Blind Spot (And the Spec Knows It)By Om-Shree-0709 on .mcpAgent IdentityOAuth 2.1
- Your AI Chatbot Just Exposed Your CEO's Salary to an InternBy Om-Shree-0709 on .Agent IdentityMCP SecurityOAuth Delegation
- Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)By Om-Shree-0709 on .Agentic AiPrompt InjectionWebAssembly
MCP directory API
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/brandonyoungdev/tldx'
If you have feedback or need assistance with the MCP directory API, please join our Discord server