Skip to content
MCP/
/
List available TLDs

MCP API (1.0.0)

Search, check availability, and purchase traditional DNS domains. This API enables AI assistants to help users find and buy domain names.

Overview
URL
https://unstoppabledomains.com
Unstoppable Domains
support@unstoppabledomains.com
Languages
Servers
Production server
https://api.unstoppabledomains.com

Search for available domains or check specific domain availability

Request

Search for domain availability and pricing. Can check a specific domain (e.g., "example.com") or search terms across multiple TLDs. Supports multiple queries in a single request for efficient batch lookups. Returns a list of matching domains with their availability status, prices, and other details. IMPORTANT: Not all ICANN TLDs are supported. Use ud_tld_list to verify TLD support before searching with specific TLDs.

Security
bearerAuth
Bodyapplication/jsonrequired
querystring or Array of stringsrequired

Domain name(s) to search - can be a full domain name like "example.com" (TLD is inferred) or a search term like "mybusiness" (searches across TLDs). Supports array of up to 10 terms for batch operations.

Example: "example.com"
One of:

Domain name(s) to search - can be a full domain name like "example.com" (TLD is inferred) or a search term like "mybusiness" (searches across TLDs). Supports array of up to 10 terms for batch operations.

non-empty
stringnon-empty
tldsArray of strings

Optional list of up to 5 ICANN TLDs to search (e.g., ["com", "org", "io"]). Must be supported TLDs - use ud_tld_list to verify. Defaults to popular TLDs (com, net, org, ai, io) or inferred from query.

Example: ["com","org","io"]
limitnumber[ 1 .. 100 ]

Maximum number of results to return (1-100, default: 20)

Example: 20
offsetnumber>= 0

Number of results to skip for pagination (default: 0)

Example: 0
curl -i -X POST \
  https://api.unstoppabledomains.com/mcp/v1/actions/ud_domains_search \
  -H 'Authorization: Bearer <YOUR_TOKEN_HERE>' \
  -H 'Content-Type: application/json' \
  -d '{
    "query": "example.com",
    "tlds": [
      "com",
      "org",
      "io"
    ],
    "limit": 20,
    "offset": 0
  }'

Responses

Search results

Bodyapplication/json
searchQuerystring

Sanitized search term (present for single query requests)

searchQueriesArray of objects

Array of search queries with metadata (present for multiple query requests)

searchedTldsArray of strings

TLDs that were searched

invalidReasonstring or null

Validation error reason (present for single query requests)

invalidCharactersArray of strings or null

Invalid characters found (present for single query requests)

resultsArray of objects(DomainResult)
paginationobject
truncatedboolean

Whether results were truncated due to size limits

truncationMessagestring

Message explaining truncation

Response
application/json
{
  "searchQuery": "string",
  "searchQueries": [
    { … }
  ],
  "searchedTlds": [
    "string"
  ],
  "invalidReason": "string",
  "invalidCharacters": [
    "string"
  ],
  "results": [
    { … }
  ],
  "pagination": {
    "total": 0,
    "count": 0,
    "offset": 0,
    "limit": 0,
    "hasMore": true,
    "nextOffset": 0
  },
  "truncated": true,
  "truncationMessage": "string"
}

List available TLDs

Request

List all available ICANN TLDs (top-level domains) supported by our registrar.

Security
bearerAuth
Bodyapplication/jsonrequired
object
curl -i -X POST \
  https://api.unstoppabledomains.com/mcp/v1/actions/ud_tld_list \
  -H 'Authorization: Bearer <YOUR_TOKEN_HERE>' \
  -H 'Content-Type: application/json' \
  -d '{}'

Responses

List of available TLDs

Bodyapplication/json
tldsArray of strings

Array of supported TLD extensions (e.g., ["com", "io", "org"])

countnumber

Total number of supported TLDs

Response
application/json
{
  "tlds": [
    "string"
  ],
  "count": 0
}

Portfolio

Manage owned domains (requires authentication)

Operations

Contacts

Manage ICANN contacts for DNS domain registration (requires authentication)

Operations

Cart

Shopping cart management, payment methods, and checkout (requires authentication)

Operations

Marketplace

List domains for sale, manage listings, and handle offers (requires authentication)

Operations

Leads

Domain conversations and messaging between buyers and sellers (requires authentication)

Operations

DNS Management

Manage DNS records, nameservers, and hosting configurations for owned domains (requires authentication)

Operations

Domain Management

Manage domain settings like auto renewal (requires authentication)

Operations