Create a domain order
create_orderCreate a registration order (a price-locked quote). A 402 is the payment challenge, not an error: pay the existing invoice and poll poll_url / check_order — do not create_order again for the same domain while status is awaiting_payment (repeats return the same order with reused:true). Returns quote{price_usd, locked_until}, pay{x402, transfer, checkout_url, poll_url}, payment requirements (exact amount_units — do not round to price_usd) and checkout_url. Policy: check availability right before buying, show the quote to the human and get confirmation before paying; pass idempotency_key (retries with the same key never create a second order; if omitted, identical calls within 15 min share a key, and any open unpaid register for the same buyer+domain is reused). pay_with=balance pays instantly from prepaid balance. Gasless: retry with x402 PAYMENT-SIGNATURE on this order pay URL, or POST /api/v1/register. Card: the 402 also carries stripe_link and stripe_card; hand the human checkout_url. dry_run=true previews quote, renewal and blockers without creating an order.
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": "create_order"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| ref | No | Affiliate ref code. Earn $0.60 per .com you refer, $0.51 per .xyz, paid weekly in USDC. | |
| chain | No | payment network (default base). hyperevm = HyperEVM (chain 999, USDC/USDT0), bsc = BNB Chain (56, 18-decimal USDC/USDT) | |
| token | No | stablecoin (default USDC) | |
| years | No | ||
| domain | Yes | ||
| api_key | No | Optional. Guest or dashboard API key (sd_live_…). Prefer Authorization: Bearer <key> on the MCP connection; if your client cannot set headers, pass the key here. | |
| dry_run | No | preview only, nothing created or charged | |
| pay_with | No | ||
| showcase | No | Opt in to the public /showcase listing (only if the user asked) | |
| nameservers | No | ||
| showcase_title | No | ||
| idempotency_key | No | ||
| showcase_category | No | Required when showcase is true | |
| showcase_description | No |