DNSMint

Tools

Token cost is the o200k count of the tools list JSON, including schemas, before any tool is called.

• list_hostnames

  Every hostname this credential can see, with how many are active and the plan's cap. Check the cap before minting: a hostname is the unit the plan counts.

• get_plan

  What this account's plan allows and how much of it is used: hostnames, dedicated domains, and whether a plan is active at all. Also says whether a checkout is outstanding, which is how you find out a

• get_hostname

  One hostname's status and certificate mode. Does not say where it points: DNS is the authoritative answer for that, so use diagnose_hostname or resolve the name.

• diagnose_hostname

  Why a hostname is or is not working: what the nameservers answer, what public resolvers see, and whether a certificate has been issued. Use this before assuming something is broken; a name minted mome

• mint_hostname

  Register an address and get back a stable hostname that survives the address changing. This is the tool to use when a machine or agent needs a name. The address class is fixed for the life of the nam

• repoint_hostname

  Point an existing hostname at a new address. This is what makes the name worth having: the machine moves, the name does not, and everything holding the URL keeps working. Repointing within an address

• release_hostname

  PERMANENTLY give up a hostname. Read this before calling it. A released hostname is tombstoned and is never issued again, to anyone, including this account. There is no undo and it cannot be re-minte

• start_checkout

  Get a payment link the account owner opens to raise this account's limits. Call this when minting fails because the account is at its hostname cap or has no plan. This charges nothing and buys nothin