Buy the domain for a live build (code prowess)
prowess_buy_domainOperator token only, during a "code prowess" build the owner authorized with a spending cap. Buys ONE domain for the business through our registrar (owner-paid; no customer charge), points it at the server and starts HTTPS. Use dry_run first to compare endings. Exact business name within the cap beats a cheaper near-miss. Auto-renew stays off. Then publish_site and poll publish_status. A refused or unchecked domain ending carries reason and a plain reason_text: unsupported or price_unavailable mean we do not sell that ending right now; lookup_failed or cap_reached mean it was NOT checked, so search again, and never tell the customer we do not sell it.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"domain": "<domain>"
},
"name": "prowess_buy_domain"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| domain | Yes | The ONE domain to buy for this business, bare, e.g. "heapy.net". Pick the exact business name on any ending that fits the grant's remaining cap before a cheaper misspelling (heapy.net at $90 beats heeepy.com at $40). Check prices first with dry_run. | |
| dry_run | No | true = quote only: registrar, cost for the minimum term, and whether it fits the cap. Buys nothing. | |
| site_key | No | The site this domain is for (optional; for your own bookkeeping). |