$ man domain-suggest
/domain-suggest(1)
PRICE / CALL
$0.05
USDC · base mainnet · scheme: exact
METHOD
POST
CLUSTER
webprobeCATEGORY
uncategorized
STATUS
● live
NAME
domain-suggest — brandable domain suggester / startup-name brainstormer / product-name proposer / domain candidate generator
SYNOPSIS
POST https://x402.org/v1/domain-suggest
Content-Type: application/json
X-PAYMENT: <signed-transferWithAuthorization>
{ ... }↳ first call →
402 Payment Required. Sign USDCtransferWithAuthorization, retry with theX-PAYMENT header.DESCRIPTION
Brandable domain suggester / startup-name brainstormer / product-name proposer / domain candidate generator. LLM brainstorms N short brandable candidates fitting a concept + tone, then verifies TLD availability across up to 6 TLDs via in-process domain-availability lookups. Returns candidates ranked by # available TLDs then brandability score, with per-TLD registrar info for each candidate. Pair with brand-clearance (Prooflayer) on the shortlist for trademark + Wikipedia + HN signal before adopting. Allowlisted TLDs: com, ai, dev, io, co, app, xyz, org, net, tech, tools, page, studio, shop.
INPUT — request schema
| property | type | description | req? |
|---|---|---|---|
| concept | string | Plain-language product / project description (1-240 chars). Example: 'graded-card portfolio tracker for collectors' or 'paid AI utility primitives for agents'. | required |
| count | number | Number of candidates to brainstorm. 1-20. Default 10. Multiplied by tlds.length must stay <= 80 lookups. | optional |
| tlds | array | TLDs to check, without dots. Default ['com','ai','dev','io','co']. Allowlist: com, ai, dev, io, co, app, xyz, org, net, tech, tools, page, studio, shop. Max 6. | optional |
| tone | string | Naming tone hint passed to the brainstorm LLM. Default 'neutral'. enum: neutral · playful · technical · luxury · industrial | optional |
OUTPUT — response shape
| field | type | description |
|---|---|---|
| concept | string | Echoes back the concept/seed phrase the caller supplied for brandable name brainstorming. |
| returned_count | string | Number of candidate names returned in the candidates array after LLM brainstorm + TLD checks. |
| tlds_checked | string | List of TLDs queried for each candidate, drawn from the 14-TLD allowlist (com, ai, dev, io, etc.). |
| candidates | string | Ranked array of brandable name candidates, each with per-TLD availability + registrar info and a brandability score. |
EXAMPLES — two ways to call
EXAMPLE 1 · curl
curl -X POST https://x402.org/v1/domain-suggest \
-H 'Content-Type: application/json' \
-d '{ }'first response =
402 Payment Required with payment requirements; sign + retry with X-PAYMENT.EXAMPLE 2 · mcp
# install once claude mcp add x402 --command "npx x402-deployer-mcp" # then ask Claude Code: # "use the domain-suggest tool to ..."
MCP server handles payment automatically — your coding agent just calls the tool by name.
METADATA
- tags
- domain-availabilitybrandable-namesstartup-namingproduct-namingtld-checkname-generatordomain-suggest
- methods
- POST
- cluster
- webprobe
- price
- $0.05 USDC per call
ADJACENT — other endpoints in webprobe
| endpoint | description | price |
|---|---|---|
| arxiv-summarize | arXiv paper summarizer / research-paper TLDR. | $0.04 |
| rss-from-anything | RSS feed generator / HTML to RSS converter. | $0.04 |
| scrape | Web scraper / HTML extractor. | $0.04 |
| scrape-website | Web scraper / HTML to text / website content extractor. | $0.04 |
| screenshot | Website screenshot / URL to PNG/JPG. | $0.04 |
| webpage-diff | Webpage change detection / website monitor / content diff. | $0.04 |
| website-screenshot | URL to PNG / JPG / website screenshot tool. | $0.04 |
| arxiv-search | arXiv full-text search. | $0.03 |
SEE ALSO