Authoritative DNS Engineered for Autonomous AI Agents

// Add OnlyDNS to your Claude Desktop or Cursor MCP settings:
// File: ~/.config/claude/claude_desktop_config.json
{
  "mcpServers": {
    "onlydns": {
      "command": "npx",
      "args": ["-y", "@onlydns/mcp"],
      "env": {
        "ONLYDNS_API_KEY": "odn_live_your_api_key_here"
      }
    }
  }
}

// Available Tools automatically exposed to LLM:
// - onlydns_list_zones: Inspect hosted domains and query quotas
// - onlydns_get_records: Retrieve current A, AAAA, CNAME, TXT records
// - onlydns_upsert_record: Programmatically provision or update records
// - onlydns_delete_record: Safely clean up ephemeral sandbox subdomains

# pip install onlydns-sdk langchain
from onlydns import OnlyDNSClient
import os

# Initialize client with agent environment key
client = OnlyDNSClient(api_token=os.getenv("ONLYDNS_API_KEY"))

def provision_agent_sandbox(run_id: str, ip_address: str) -> str:
    """Agent tool to provision an ephemeral development domain."""
    subdomain = f"agent-{run_id}"
    
    # Upsert DNS A record with 60s TTL for fast propagation & tear-down
    result = client.records.upsert(
        domain="myagents.ai",
        name=subdomain,
        record_type="A",
        ttl=60,
        records=[ip_address]
    )
    
    return f"https://{subdomain}.myagents.ai"

# Dynamic DNS via RFC 2136 TSIG update (Zero REST latency)
cat <<EOF | nsupdate -k tsig-agent-key.key
server ns1.onlydns.com
zone myagents.ai
update delete ephemeral.myagents.ai A
update add ephemeral.myagents.ai 60 A 192.0.2.42
send
EOF

# Rapid confirmation across global Anycast edge (0.2–5s)
dig @ns1.onlydns.com ephemeral.myagents.ai +short
# Output: 192.0.2.42 (Active immediately)

# Create / Update DNS Record via REST API
curl -X PUT "https://api.onlydns.com/v1/dns/myagents.ai/records" \
  -H "Authorization: Bearer odn_live_your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '[
    {
      "name": "preview-agent-01",
      "type": "CNAME",
      "ttl": 120,
      "records": ["sandbox-cluster.cloudprovider.internal."]
    }
  ]'