register_domain

com.atom/premium-domains · Verify this server

Purchase/register a domain by DEBITING the authenticated user's Atom account balance. This SPENDS REAL MONEY and requires the 'domains:register' scope. Use only when the user clearly wants to buy now from their Atom balance; otherwise use get_checkout_link (pay per purchase). MANDATORY two-step flow — never skip the quote: 1) Call with confirm=false (default) to get a QUOTE: returns stage='quote', the authoritative price, currency, balance_after, sufficient_funds, and expires_at. Show this to the user and get explicit confirmation. 2) Call again with confirm=true and the SAME idempotency_key to commit: returns stage='committed', amount_debited, balance_remaining, and order_id. PAYMENT PRIORITY for buying a premium/marketplace domain: this tool (Atom account balance) is priority 1 — try it first. If funds are insufficient, priority 2 is get_domain_purchase_pay_link, paid via link-cli's tools (e.g. mpp_pay), if those are present in this session. Only if link-cli isn't available either does it fall to priority 3 (last resort): get_checkout_link. Rules: never assume or pass a price — the server is authoritative. Reuse one client-generated idempotency_key across both calls (and any retry) to prevent double-charging. If funds are insufficient the tool returns error 'insufficient_funds' with required/available/top_up_url — in that case follow the priority above (link-cli, then get_checkout_link). Always confirm with the user before the confirm=true call.