Wait for a domain to verify
wait_for_domainWaits until a sending domain is verified or failed, letting you track DNS verification without rechecking it yourself; use timeout=0 for a snapshot.
Instructions
Purpose: wait until a sending domain is verified or failed, without re-checking DNS yourself. Pass the id or the domain name as domain (name means the same thing). timeout=0 is a snapshot of the last check. NOT for: publishing DNS, or forcing a new lookup (verify_domain). The server keeps checking on its own for 72 hours. Returns: status, next_poll_seconds (when the server will check again), deadline (when the 72-hour window closes), reason, and progress (required_verified of required_total). If it is still pending, call again after next_poll_seconds, or send to an address ending in @simulator.agentisend.com meanwhile.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"domain": "<domain>"
},
"name": "wait_for_domain"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| domain | Yes | Domain id from create_domain, or the domain name. name is an alias for this argument. | |
| timeout | No | Seconds to wait, 0–25. 0 returns the last stored check immediately. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| error | No | Present instead of the fields above when the call was refused: code, message, fix, docs_url, retryable and, when waiting helps, retry_after_seconds. | |
| reason | No | ||
| status | No | ||
| deadline | No | When the 72-hour window closes. | |
| progress | No | required_verified of required_total. | |
| next_poll_seconds | No | When the server checks again. |