doDomain connection health
Report which of the team's domain connections are healthy, which are broken, and queue a DNS recheck where the user asks for one.
Connecting and calling the tools
Every tool in this skill comes from the dodomain MCP server, the doDomain connector, and is written here as dodomain:<tool>.
- Tools listed by name: call them directly, for example
dodomain:check_domain. - Only
dodomain:search_toolsanddodomain:execute_typescriptlisted (Code Mode, the default): calldodomain:search_toolsfirst, then call each tool insidedodomain:execute_typescriptasexternal_<tool>(for exampleexternal_check_domain); the program mustreturnits result. Scopes, confirmations and gates are identical on both surfaces. - "Tool not found": switch to the Code Mode route instead of retrying the direct call. If
dodomain:search_toolsdoes not return the tool either, its OAuth scope was not granted; the user reconnects doDomain and approves that scope. - No
dodomaintools at all: doDomain is not connected yet. Install the doDomain power, which adds the server; it signs in with OAuth on first use.
Tools you will use
dodomain:list_apps: app ids and names, so connections can be grouped by app.dodomain:list_connections: connections withstatus,fqdn, and theverifiedAt,lastCheckedAt, andbrokenAttimestamps. Filter by app or domain. Paginated.dodomain:reverify_connection: queue an on-demand DNS recheck of one connection. Returns{ accepted: true }; the check runs asynchronously and does not return a verdict.dodomain:check_domain: provider and zone for a broken domain, so the user knows which DNS provider the customer uses.
Workflow
- Call
dodomain:list_apps, thendodomain:list_connectionsfor the app the user named, or for every app when they asked about the whole team. Follow pagination until you have the full set. - Group the results by status. List broken connections first with
fqdn,brokenAt, andlastCheckedAt, then healthy ones withverifiedAt. - For each broken connection the user cares about, call
dodomain:check_domainto name the DNS provider behind it. - If the user asks for a recheck, confirm which connection, then call
dodomain:reverify_connectiononce. - Tell the user the recheck is queued and runs in the background. Offer to read the result back later with
dodomain:list_connections.
Rules
dodomain:reverify_connectionanswers{ accepted: true }and nothing else. Never report that as the domain being verified.- Rechecks are rate limited. On
RATE_LIMITED, reportretryAfterSecondsand stop. Never loop on rechecks. - An unknown connection id returns
NOT_FOUND. Say the connection is not on this team and offerdodomain:list_connections. - Report timestamps in the user's timezone and say which timezone you used.
