Tools

The NameBeta MCP server has five tools. Your assistant picks them itself; naming a tool in your request makes it more likely to use that one.

Tool	What it does
check_availability	Checks 1–20 domains; a bare label such as kettlory expands across the default TLD set
compare_prices	Lists registration and renewal prices for one domain at every registrar we track
suggest_domains	Derives domain names and domain hacks from a piece of text
lookup_whois	Returns registrar, expiration date, nameservers, EPP status and raw WHOIS data
lookup_dns	Returns DNS records of one type: A, AAAA, CNAME, MX, TXT, NS, SRV or SOA

Each tool is the website's own feature over another channel: check_availability is the search box, compare_prices is a domain's price page, and lookup_whois and lookup_dns are the WHOIS and DNS tools.

How they fit together

Finding a name to register usually takes three or four calls:

1. suggest_domains turns an idea into candidate names. It says nothing about availability.
2. check_availability checks the candidates, up to 20 per call.
3. compare_prices lists what each registrar charges for a domain that is available. Weigh the renewal price as well as the first-year price.
4. lookup_whois confirms the status of a domain you are about to register, or tells you when a taken one expires.

lookup_dns stands apart: it shows what a registered domain points to, such as its mail servers.

What the tools cannot do

• They only look things up. No tool registers, renews or changes a domain; compare_prices links to the registrar, where you complete the registration.
• They add nothing the website lacks. MCP is another way in to the same features and the same data, and it does not loosen any limit; see Quotas.
• They do not see your account's domains. Signing in identifies whose plan a call counts against; the tools do not read or change anything else in your account.

Every tool page follows the same layout: the tool's behavior hints, a prompt you can paste into your assistant, Input, Output, Behavior, Example, Quota, and the errors specific to that tool.

Behavior hints

Every tool declares the MCP tool annotations readOnlyHint: true, destructiveHint: false and openWorldHint: true, shown at the top of each tool page as Read-only · Open world. Read-only means the tool changes nothing, so clients that honor the hint can run it without asking you each time. Open world means it queries systems outside NameBeta — registries, WHOIS servers and nameservers — so its results contain text NameBeta does not control. Security explains what that means for your assistant.