cf_resolve_zone
Resolve a zone ID by providing its canonical DNS name. Returns zone details including account ID.
Instructions
Look up a zone ID by its name (the canonical DNS name).
Args:
zone_name: e.g. "example.com". Trailing dots are stripped.
Calls: GET /zones?name=<zone_name>&match=all.
Returns: envelope with `data = {zone_id, zone_name, account_id, ...}`.
Errors:
- zone_not_allowed when the resolved zone is outside CF_ZONE_ALLOWLIST.
- not_found when zero zones match.
- validation when more than one zone matches the same name (rare but
possible across multiple accounts — agent must disambiguate).
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": {
"zone_name": "<zone_name>"
},
"name": "cf_resolve_zone"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| zone_name | Yes |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |