# Domain tools (https://developer.godaddy.com/en/docs/api-users/mcp/tools/domains)

---
title: Domain tools
description: >-
  Reference for the GoDaddy MCP server's domain tools, check_domain_availability
  and suggest_domains: parameters, limits, results, and example prompts.
keywords: >-
  check_domain_availability parameters, suggest_domains parameters, MCP domain
  availability tool, MCP domain suggestions, bulk domain check MCP, currency
  parameter, domain registration link
agentNotes:
  permissions:
    - Public (no account required)
  scopes:
    - Not applicable (current tools use public data only)
  rateLimit: Usage limits apply.
  idempotent: true
  destructive: false
  failureRecovery: >-
    Safe to retry. Invalid domains are skipped and listed rather than failing
    the call.
related:
  guides:
    - title: Connect to the GoDaddy MCP server
      href: /docs/api-users/mcp/set-up
    - title: Search domain availability
      href: /docs/api-users/domains/search
  apis:
    - title: 'Domains v3: Discovery'
      href: /docs/references/rest/domains/v3/get-domain-availability
  concepts:
    - title: GoDaddy MCP server
      href: /docs/api-users/mcp
pageId: ef1984dd-079a-4ad6-b7f8-25eddafa2c6f
---

## 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

| Parameter  | Type   | Required | Description                                                                                                                                                                                      |
| ---------- | ------ | -------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `domains`  | string | Yes      | One or more full domain names, including the TLD, separated by commas or spaces. For example, `example.com, example.net`.                                                                        |
| `currency` | string | No       | ISO 4217 currency code for pricing. Defaults to the request locale's currency, or `USD` when the locale is unknown. Go to [Supported currencies](#supported-currencies) for the accepted values. |

### 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

| Parameter  | Type    | Required | Default                             | Description                                                                                                      |
| ---------- | ------- | -------- | ----------------------------------- | ---------------------------------------------------------------------------------------------------------------- |
| `query`    | string  | Yes      | None                                | Keywords, a seed domain, or a short business description. Maximum 300 characters.                                |
| `limit`    | integer | No       | `40`                                | Maximum number of suggestions to return, from `1` to `100`.                                                      |
| `currency` | string  | No       | Request locale's currency, or `USD` | ISO 4217 currency code for pricing. Go to [Supported currencies](#supported-currencies) for the accepted values. |

### 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:

```text
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
```