Public Sites

Core Platform
sites_readAI Agent

Show which published apps are on the internet: their address, whether visitors need a password, and their custom domains with each domain's status and problems. An AI Agent sees only the apps it hosts. Use get for the exact DNS records a custom domain needs, then sites_write verify_domain once they're added. People turn sites on and add domains in the app.

Actions:

  • list: List public sites. Apps with a site at the facility (including ones turned off), without DNS records.
  • get: Get a public site. One site with every custom domain's DNS records: type, name (relative to the domain), host (full name), value and purpose (verify, route, route-alternative or caa). Needs appId.

Parameters

NameTypeDescription
action*"list" | "get"What to do; each action is described in the tool description.
limitintegerItems per page (default 25, at most 100) (list)
cursorstringnextCursor from the previous page (list)
facilityIdstringFacility ID. Optional when the connected facility is the one you mean.
appIdstringPublished app id from sites_read list (get)
sites_writeAI Agent

Check a custom domain's DNS records now and connect it to its site when they're right (the domain then serves the site over HTTPS). Get the records to add with sites_read get. Adding domains, turning sites on and setting passwords are done by people in the app.

Actions:

  • verify_domain: Verify a custom domain. Returns the domain's status (pending, verified, failed or lapsed), any problems with their fixes, its records and a next step. Repeat checks within a few seconds return the last result. Needs appId, domain.

Parameters

NameTypeDescription
action*"verify_domain"What to do; each action is described in the tool description.
appIdstringPublished app id from sites_read list
domainstringA custom domain already added to the app's site, e.g. www.example.com
facilityIdstringFacility ID. Optional when the connected facility is the one you mean.