{
  "schemaVersion": "aidomainassistant.agent-card/1.0",
  "name": "DomainDiscovery",
  "description": "DomainDiscovery (also written Domain Discovery or Domains Discovery) is a free web app for domain name search and domain research. Founders, agencies, and local businesses use it to check whether a name is available across 1,600+ top-level domains (TLDs), generate brandable ideas, build geo domain lists for multi-city campaigns, run bulk availability checks, look up public WHOIS/RDAP registration data, browse extensions, compare regular-style registrar pricing by TLD. Core to",
  "url": "https://www.domainsdiscovery.com",
  "provider": {
    "name": "DomainDiscovery",
    "url": "https://www.domainsdiscovery.com",
    "alternateNames": [
      "Domain Discovery",
      "Domains Discovery"
    ]
  },
  "protocols": [
    "mcp",
    "https-jsonrpc",
    "rest"
  ],
  "endpoints": {
    "mcp": "https://www.domainsdiscovery.com/api/mcp",
    "auto": "https://www.domainsdiscovery.com/api/agent/auto",
    "chat": "https://www.domainsdiscovery.com/api/ada/chat",
    "jobs": "https://www.domainsdiscovery.com/api/agent/jobs/{id}",
    "manifest": "https://www.domainsdiscovery.com/api/agent/manifest",
    "skills": "https://www.domainsdiscovery.com/api/agent/skills",
    "health": "https://www.domainsdiscovery.com/api/agent/health",
    "register": "https://www.domainsdiscovery.com/api/agent/register",
    "agentCard": "https://www.domainsdiscovery.com/.well-known/agent-card.json",
    "llms": "https://www.domainsdiscovery.com/llms.txt",
    "assistantHub": "https://www.domainsdiscovery.com/assistant",
    "productApp": "https://www.aidomainassistant.com",
    "chatUi": "https://www.domainsdiscovery.com/ada/chat"
  },
  "capabilities": [
    "domain_name_search",
    "brand_domain_ranking",
    "conversational_chat",
    "budget_filter",
    "whois_rdap",
    "geo_domain_lists",
    "tld_price_research",
    "bulk_availability_check",
    "agent_mcp_tools",
    "byok_llm_invent",
    "byok_registrar_opt_in"
  ],
  "tools": [
    {
      "name": "find_brand_domains",
      "description": "AUTO: brand brain → Instant Domain check → rank → shortlist under maxBudgetUsd"
    },
    {
      "name": "list_agent_skills",
      "description": "Skill layers L0–L3 + BYOK requirements (LLM / registrar)"
    },
    {
      "name": "list_agent_registrars",
      "description": "Registrars with API register/DNS for agents (Porkbun, Namecheap, Cloudflare, GoDaddy, Route 53, …)"
    },
    {
      "name": "ada_chat",
      "description": "Conversational domain assistant (POST /api/ada/chat) — humans + agents"
    },
    {
      "name": "get_product_facts",
      "description": "Canonical product facts for agents"
    },
    {
      "name": "parse_business_brief",
      "description": "Free text → structured DomainBrief"
    },
    {
      "name": "generate_domain_names",
      "description": "Candidate names from brief/keywords"
    },
    {
      "name": "check_domain_availability",
      "description": "Live Instant Domain MCP check (max 50)"
    },
    {
      "name": "rank_domains",
      "description": "Score brand fit with explainable breakdown"
    },
    {
      "name": "whois_lookup",
      "description": "Public WHOIS/RDAP registration data"
    },
    {
      "name": "generate_geo_domains",
      "description": "City/country + keyword patterns"
    },
    {
      "name": "compare_tld_prices",
      "description": "Regular-style TLD price research"
    },
    {
      "name": "register_domain",
      "description": "L3 roadmap: BYOK registrar register + human confirm (fail-closed)"
    },
    {
      "name": "set_dns_records",
      "description": "L3 roadmap: BYOK DNS mutation + human confirm (fail-closed)"
    }
  ],
  "constraints": {
    "registersDomains": false,
    "modifiesDns": false,
    "humanConfirmForPurchase": true,
    "inventsPrices": false
  },
  "budget": {
    "parameter": "maxBudgetUsd",
    "currency": "USD",
    "statuses": [
      "within",
      "over",
      "unknown"
    ],
    "notes": "Pass maxBudgetUsd on find_brand_domains or POST /api/agent/auto. Price often unknown until registrar checkout."
  },
  "pricing": {
    "model": "research_free_v1",
    "notes": "Domain registration paid at third-party registrar. No auto-purchase in v1."
  },
  "security": {
    "auth": [
      "Bearer AGENT_API_KEY",
      "x-agent-api-key",
      "AGENT_REQUIRE_AUTH in production"
    ],
    "recommendations": [
      "Set AGENT_API_KEY + AGENT_REQUIRE_AUTH=true in production",
      "Never embed registrar API secrets in browser clients long-term",
      "Enforce maxBudgetUsd in agent policies",
      "Treat availability as a snapshot; re-check before pay",
      "Require human confirmation before register/DNS automation",
      "Rate-limit agent callers; use idempotent retries",
      "BYOK LLM: x-ada-llm-provider + x-ada-llm-api-key (request-scoped)"
    ]
  },
  "version": "0.3.0",
  "documentation": {
    "agentHub": "https://www.domainsdiscovery.com/assistant",
    "integration": "https://www.domainsdiscovery.com/assistant#integration",
    "security": "https://www.domainsdiscovery.com/assistant#security",
    "mcp": "https://www.domainsdiscovery.com/api/mcp",
    "skills": "https://www.domainsdiscovery.com/api/agent/skills",
    "health": "https://www.domainsdiscovery.com/api/agent/health",
    "production": "docs/agent/PRODUCTION.md",
    "ada": "https://www.aidomainassistant.com",
    "adaDocs": "https://www.aidomainassistant.com/docs"
  },
  "relatedStandards": [
    "Model Context Protocol (MCP)",
    "GoDaddy Agent Name Service (ANS) — industry direction for agent discovery and identity",
    "DNS / Domain Connect — future DNS automation pattern"
  ]
}