URL: /mcp/tools/registration --- title: Registration tools description: Register and renew domains, read the org balance, and poll pending confirmations. --- These tools spend money. Every state-changing call routes through the agent confirmation pipeline — when the action exceeds the user's threshold or registers ≥5 domains in one call, the response is `status: "pending_confirmation"` with a token and `approve_url`. The user must approve out-of-band. Call again with the same `request_id` after approval to execute. ## `register_domains` Register one or more domains for the org. Required scope: `domains:write`. List of domain names. 1–10. Client idempotency key. Same id replays the original ActionLog row instead of registering twice. Free-text rationale; logged as a hash for audit. `balance` debits the prepaid org balance (auto-tops-up if configured); `card` charges the saved default card directly. `completed`, `pending_confirmation`, `duplicate`, `failed`, `requires_action` (3DS). Present when `pending_confirmation`: `oid`, `token`, `expires_at`, `amount_cents`, `approve_url`. Per-domain outcome on success. Present on `failed`. ## `renew_domain` Renew one domain. Required scope: `domains:write`. 1–10. Same response shape as `register_domains`. Only `balance` funding is supported. ## `get_balance` Required scope: `orgs:read`. ## `list_my_confirmations` The caller's pending confirmations. Use after a `pending_confirmation` response to poll for status, or to surface a list of "things waiting on you" to the user. Required scope: `orgs:read`.