Tool · Catalog
suggest_domains
Suggest available domains based on a keyword stem, with USD pricing.
Read-onlyIdempotentOpen‑worldscope read:domain_catalog
Invoked over the MCP transport with a tools/call request naming this tool.
Authorization #
Requires a valid OAuth 2.1 bearer access_token whose grant includes the read:domain_catalog scope — Check domain availability and get EUR pricing from JetHost's catalog. The broker resolves the caller from the token and returns only records the account owns.
Parameters #
stemstringRequired
The keyword, brand, or business name to generate domain suggestions from — a single word or short phrase, e.g. "bakery" or "handmade studio". Pass the stem only: NOT a full domain name and NOT a TLD. This is the only argument; its name is "stem".
Response #
200 · application/json
domainsarray<object>
domain_namestring
sldstring
tldstring
statusstring
One of: available registered reserved unknown
register_pricestring · null
transfer_pricestring · null
is_premiumboolean
sellableboolean
currencystring
free_with_hostingboolean
True when this TLD can be registered free of charge if ordered together with a qualifying JetHost hosting plan. See free_with_products for which plans and billing cycles qualify.
free_with_productsarray<object>
Hosting plans that include this domain free when ordered together. Empty when the domain is not free with any plan.
product_idinteger
WHMCS product id of the qualifying hosting plan.
product_namestring
Display name of the qualifying hosting plan.
billing_cyclesarray<string>
Billing cycles on which the free domain applies (e.g. "annually", "biennially", "triennially"). The customer must pick one of these terms for the domain to be free.
Errors #
| Result | When |
|---|---|
| { "error": "stem_required" } | See the tool description for when this result is returned. |