Domain tools

Overview

This page documents the domain tools on the GoDaddy MCP server at https://mcp.godaddy.com. Both tools are read-only, use public domain data, and don't require authentication.

You don't call these tools directly. Your AI client picks a tool and fills in its parameters from your prompt. Knowing the parameters and limits helps you write prompts that get the results you want.

Both tools return the same result shape:

• Text: A formatted summary that any client can display.
• Structured content: The same results as data, which clients that render MCP Apps show as an interactive domain list.
• Registration links: Every available domain carries a GoDaddy link that adds the domain to a cart on godaddy.com.
• Pricing: First-year and renewal prices in the requested currency.

The tool descriptions tell the AI client to always show the registration links. If your client hides them, ask it to show the links.

check_domain_availability

Checks whether one or more exact domain names are available to register. For each domain, the result shows whether it's available, premium, in auction, or taken, plus pricing and a registration link for available domains.

• Authentication: None
• Read-only: Yes
• Destructive: No

Parameters

Limits and behavior

• Domains per call: Up to 50. A call with more than 50 valid domains returns an error that states the limit.
• Invalid entries: Entries that aren't valid domain names are skipped and listed under Skipped domains. The rest of the call still runs.

Example prompts

• "Is brightleaf.com available?"
• "Check brightleaf.com, brightleaf.net, brightleaf.io, and brightleaf.co."
• "What does brightleaf.ca cost in Canadian dollars?"

suggest_domains

Generates domain name ideas from keywords, a seed domain, or a short business description. Each suggestion includes pricing and a registration link.

Suggestions aren't guaranteed to be available. Ask your client to check a suggestion with check_domain_availability before you register it.

• Authentication: None
• Read-only: Yes
• Destructive: No

Parameters

Limits and behavior

• Duplicate removal: Results are de-duplicated and capped at limit.

Example prompts

• "Suggest domains for a sustainable fashion brand."
• "Give me 10 short domain ideas for a coffee roaster in Portland."
• "Suggest alternatives to techcompany.io, priced in euros."

Supported currencies

The currency parameter accepts these ISO 4217 codes:

AED  ARS  AUD  BRL  CAD  CHF  CLP  COP  DKK  EUR  GBP
HKD  IDR  ILS  INR  JPY  KRW  MXN  MYR  NZD  PEN  PHP
PKR  PLN  SEK  SGD  THB  TRY  TWD  UAH  USD  VND  ZAR

Last updated on