Agent Hub · MCP · Budget-aware research

AI Domain Assistant

Agent-ready domain intelligence on DomainDiscovery. Demo auto shortlists with a budget cap, or connect via MCP / REST so agents can find and rank brands. Research only — you confirm registration.

Describe your business

Try an example

Agent budget$research cap · not a payment

Important

Availability is a snapshot and can change. DomainDiscovery is not a registrar — registration and payment happen at a third-party registrar. Rankings are research signals, not legal trademark advice.

Agents can call the same pipeline via agent manifest or MCP — see docs/agent/MCP.md.

Your ranked shortlist will appear here after you run Find domains.

For AI agents

How agents use DomainDiscovery

This page is the Agent Hub on DomainDiscovery: machine-callable tools for domain research. DomainDiscovery is a research toolkit — not a registrar. Agents propose and rank names under a budget; humans confirm registration at a registrar that supports their workflow.

Integration Security Agent Card ADA Agent Card

1. Connect

MCP, REST /api/agent/auto, or chat /api/ada/chat

2. Call tools

find_brand_domains with brief + maxBudgetUsd

3. Human confirms

User registers at registrar — no auto-buy (v1)

Tool catalog

Tool	What it does
find_brand_domains	AUTO: brief → generate → check → rank → shortlist (primary)
get_product_facts	Canonical product facts for agents
parse_business_brief	Free text → structured DomainBrief
generate_domain_names	Candidate names from brief/keywords
check_domain_availability	Live check up to 50 domains
rank_domains	Score brand fit with explainable breakdown
whois_lookup	Public WHOIS/RDAP registration data
generate_geo_domains	City/country + keyword patterns
compare_tld_prices	Regular-style TLD price research

MCP over HTTP (JSON-RPC)

tools/list

curl -s -X POST http://localhost:5001/api/mcp \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

find_brand_domains + $20 budget

curl -s -X POST http://localhost:5001/api/mcp \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json' \
  -d '{
    "jsonrpc": "2.0",
    "id": 2,
    "method": "tools/call",
    "params": {
      "name": "find_brand_domains",
      "arguments": {
        "text": "AI scheduling SaaS for dental clinics",
        "count": 8,
        "style": "brandable",
        "maxBudgetUsd": 20,
        "skipAvailability": false
      }
    }
  }'

REST auto API

POST /api/agent/auto

curl -s -X POST http://localhost:5001/api/agent/auto \
  -H 'Content-Type: application/json' \
  -d '{
    "text": "Eco meal kits for busy families",
    "maxBudgetUsd": 20,
    "brief": { "count": 10, "style": "mixed" }
  }'

POST /api/agent/auto (TLDs + include/avoid + strategies)

curl -s -X POST http://localhost:5001/api/agent/auto \
  -H 'Content-Type: application/json' \
  -d '{
    "text": "Fitness gym for professionals",
    "maxBudgetUsd": 20,
    "brief": {
      "preferredTlds": [".com", ".fit"],
      "mustInclude": ["fit", "strength"],
      "avoid": ["cheap"],
      "strategies": ["available_first", "radio_test", "brandable", "short", "no_hyphen"]
    }
  }'

POST /api/ada/chat (conversational agents)

curl -s -X POST http://localhost:5001/api/ada/chat \
  -H 'Content-Type: application/json' \
  -d '{
    "client": "agent",
    "skipIntake": true,
    "maxBudgetUsd": 20,
    "messages": [
      {
        "role": "user",
        "content": "Gym for busy professionals. Extensions: .com .fit. Include: fit, strength. Avoid: cheap. Strategies: radio test, brandable, available first."
      }
    ]
  }'

Cursor / Claude Desktop (stdio)

{
  "mcpServers": {
    "domaindiscovery": {
      "command": "node",
      "args": ["scripts/mcp-domaindiscovery.mjs"],
      "cwd": "/absolute/path/to/DomainDiscovery"
    }
  }
}

Endpoints

/api/mcp — MCP HTTP + JSON-RPC fallback
/api/agent/auto — sync auto shortlist
/api/agent/manifest — machine-readable capabilities
/llms.txt — product index for assistants

Optional auth: set AGENT_API_KEY and send Authorization: Bearer …. Local stdio: npm run mcp:server. Full notes: docs/agent/MCP.md.

Budget contract for agents

Pass maxBudgetUsd (e.g. 20). Results include budgetStatus: within | over | unknown. Prices are research snapshots when available — many names have unknown create fees until registrar checkout. Agents must not invent prices.

Product home

Consumer app & future chat/skills live at aidomainassistant.com. This DomainDiscovery page remains the Agent Hub (MCP + research demo). Local preview: /ada.

Skills, memory & auto-register (roadmap)

· Now: auto shortlist + rank + budget flags + MCP tools (research only).
· Next (dedicated Assistant product): chat UI, brand skills, session memory (liked/rejected names), always-on budget.
· Later: registrar API adapters for automated registration + DNS — only after explicit human confirm and hard budget stop, for registrars that support full API automation.

Integration

How external agents and runtimes connect. Same tools power DomainDiscovery Agent Hub and aidomainassistant.com.

1. Agent Card (discovery)

Fetch /.well-known/agent-card.json or /ada/.well-known/agent-card.json. Lists capabilities, endpoints, constraints.

2. MCP

HTTP: POST http://localhost:5001/api/mcp · stdio: npm run mcp:server. Primary tool: find_brand_domains.

3. REST auto

POST /api/agent/auto with text + maxBudgetUsd. Poll /api/agent/jobs/:id if async.

4. Manifest

/api/agent/manifest — tool list + install hints. Also /llms.txt.

Partner / registrar automation (later)

Future thin orchestrator (ANS-style): you supply registrar credentials; we validate budget, confirm with a human, then call register + DNS APIs (Domain Connect where possible). Async job pattern for propagation. Not enabled in v1.

Security

Agent-facing security model for DomainDiscovery / AI Domain Assistant research tools. Inspired by industry patterns (DNS-anchored trust, least privilege) — v1 does not register domains or change DNS.

Auth: Optional AGENT_API_KEY via Authorization: Bearer … or x-agent-api-key on MCP/HTTP.
Budget hard filter: Agents should send maxBudgetUsd. Results use within / over / unknown — never invent prices.
No unattended spend: registersDomains: false, modifiesDns: false. Future automation requires explicit human confirm + re-check of budget.
Snapshots: Availability and prices change; re-check at registrar checkout.
Idempotent tools: Safe to retry tool calls; use job ids for long runs.
Secrets: Never put registrar API keys in browser bundles. Rate-limit agent callers.
Industry direction: GoDaddy Agent Name Service (ANS) aims for DNS + certificate + Agent Card discovery. We publish an Agent Card now; full ANS registration is optional later.

Safety

DomainDiscovery does not process domain payments or change DNS. Availability and price signals can change. Registration and DNS management happen at your registrar (or future connected APIs with confirmation). Not trademark legal advice.

Definition

What is the AI Domain Assistant (Agent Hub)?

The AI Domain Assistant on DomainDiscovery is an agent hub: MCP and REST tools that generate domain ideas, check availability, rank brand fit, and apply a registration budget filter (for example $20 max). It is research-only — DomainDiscovery does not register domains or change DNS; humans confirm at a registrar. A dedicated Assistant product site will add chat, brand skills, and memory.

Agent manifest →