Find and register a domain
An agent can check availability and live pricing for names and TLD variants withsearchDomainAvailability,
then register the one you pick with
registerDomain — the same quote →
charge → provision flow as the UI. Try prompts like:
Is acmeplumbing.com available? Check .co and .io too, and show me prices.
Register acmeplumbing.com for 2 years if it’s under $30. Use our business address for the WHOIS contact.The agent searches first, uses the quoted prices to set the registration’s spend ceiling — a multi-year registration totals the first year at the registration price plus each additional year at the renewal price (see What you pay) — and, at the default Ask permission, asks for your approval before anything is charged (see Approvals and spending). WHOIS privacy and auto-renewal are on by default. Initial DNS is configured automatically, so the domain is ready for email addresses once it’s active.
Verify a domain you own elsewhere
For a domain registered at another provider, an agent first adds the domain to Bizzy withcreateDomain (if it isn’t
there already), then starts ownership verification with
verifyDomain. Verification returns
the TXT record you need to publish at your DNS host, then checks for it —
verification also keeps being re-checked hourly in the background, and the agent
can poll for the result at any time.
Verify getbizzy.net — give me the TXT record I need to add at Cloudflare.
Has getbizzy.net finished verifying yet?A verification token lasts 7 days; if it expires before the record shows up, asking again starts a fresh one. See Verify a domain for the underlying flow.
Manage DNS records
For domains registered through Bizzy, an agent can list, create, update, and delete DNS records (listDnsRecords,
createDnsRecord,
updateDnsRecord,
deleteDnsRecord). The DNS zone is
created automatically the first time a record is added. This is handy for the
fiddly records other services ask you to add:
Add the TXT record Stripe gave me to acmeplumbing.com:
stripe-verification=4c22…
Point acmeplumbing.com at 203.0.113.7 and www at the root domain.
What DNS records does acmeplumbing.com have right now?Domains verified with Bizzy but hosted elsewhere keep their DNS at your provider — the agent can tell you what to add (as in the verification and deliverability flows) but can’t change records there. See Managing DNS Records for the supported record types and cautions around email-critical records.
Renew a registration
An agent can preview a renewal price withgetDomainRenewalPrice and
renew with renewDomain, which charges
the account’s default payment method and extends the expiration date. If the
registrar renewal fails after the charge, the charge is refunded automatically.
What would it cost to renew acmeplumbing.com for 3 years?
Renew acmeplumbing.com for a year if it’s still under $20.Registered domains auto-renew by default, so manual renewal is mostly for domains where you’ve turned auto-renew off or want to extend further ahead.
Approvals and spending
Two domain tools spend real money:registerDomain and renewDomain. Three
independent safeguards keep an agent from spending more than you intend:
- A hard spend ceiling per call. Both tools require
maxAmountCents. If the live price already exceeds it, the call fails withPRICE_EXCEEDS_MAXIMUMand nothing is charged. The ceiling is enforced again right before the actual charge, so if the price rises after a renewal is queued, the renewal fails instead of charging above your ceiling. - Preview before commit. Each spend tool has a read-only pricing
counterpart (
searchDomainAvailabilityfor registration,getDomainRenewalPricefor renewal) the agent uses to quote first and pick the ceiling. Retries reuse an idempotency key, so a retried call replays the original result instead of charging twice. - Human approval. Both tools default to Ask, so in agent chat you get
an inline approval card — showing the exact tool
input, including the ceiling — before anything is charged. External MCP
clients have no approval step, so over MCP these tools are hidden unless you
explicitly set their permission to Allow. Each has its own permission
(
domain-registrations.purchaseanddomain-registrations.renewal) that is never inherited from a broader grant — allowing other domain tools does not enable spending.
Next steps
Domain tools reference
Parameters, permissions, and return shapes for every domain tool
Tool permissions
Set Allow, Ask, or Deny per tool on each agent