Skip to content

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.

Languages
Servers
Production server
https://api.unstoppabledomains.com

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

Create marketplace listings

Request

List one or more domains for sale on the marketplace. Supports buy-now pricing, offers, and lease-to-own options.

Security
bearerAuth
Bodyapplication/jsonrequired
domainsArray of objects[ 1 .. 50 ] itemsrequired
domains[].​domainNamestringrequired

The domain name to list

domains[].​priceInCentsnumber

Buy-now price in cents (0 for offers-only)

domains[].​expiresAtstring

Listing expiration date as ISO 8601 string (e.g., "2025-12-31"). Must be 1-36500 days from now. Default: 90 days.

domains[].​isEmailAliasUsedboolean

Enable message seller feature

domains[].​listingSettingsobject
domains[].​leaseToOwnOptionsobject

Optional lease-to-own configuration for the domain listing

curl -i -X POST \
  https://api.unstoppabledomains.com/mcp/v1/actions/ud_listing_create \
  -H 'Authorization: Bearer <YOUR_TOKEN_HERE>' \
  -H 'Content-Type: application/json' \
  -d '{
    "domains": [
      {
        "domainName": "string",
        "priceInCents": 0,
        "expiresAt": "string",
        "isEmailAliasUsed": true,
        "listingSettings": {
          "isOfferFeatureEnabled": true,
          "minOfferAmountInCents": 0,
          "domainDisplayName": "string"
        },
        "leaseToOwnOptions": {
          "type": "equal_installments",
          "maxTermLength": 2,
          "downPaymentPercentage": 0
        }
      }
    ]
  }'

Responses

Listing creation results

Bodyapplication/json
resultsArray of objects
successCountnumber
failureCountnumber
messagestring
signatureRequiredboolean
signatureNotestring
Response
application/json
{ "results": [ {} ], "successCount": 0, "failureCount": 0, "message": "string", "signatureRequired": true, "signatureNote": "string" }

Update marketplace listings

Request

Update price, settings, or options for existing listings.

Security
bearerAuth
Bodyapplication/jsonrequired
listingsArray of objects[ 1 .. 50 ] itemsrequired
listings[].​idnumberrequired

Listing ID

listings[].​priceInCentsnumber
listings[].​expiresAtstring

New listing expiration date as ISO 8601 string (e.g., "2025-12-31"). Must be 1-36500 days from now.

listings[].​isEmailAliasUsedboolean
listings[].​listingSettingsobject

Listing-level settings such as offers and display preferences.

listings[].​leaseToOwnOptionsobject

Lease-to-own configuration options for the listing.

curl -i -X POST \
  https://api.unstoppabledomains.com/mcp/v1/actions/ud_listing_update \
  -H 'Authorization: Bearer <YOUR_TOKEN_HERE>' \
  -H 'Content-Type: application/json' \
  -d '{
    "listings": [
      {
        "id": 0,
        "priceInCents": 0,
        "expiresAt": "string",
        "isEmailAliasUsed": true,
        "listingSettings": {
          "minOfferAmountInCents": 0,
          "isOfferFeatureEnabled": true,
          "domainDisplayName": "string"
        },
        "leaseToOwnOptions": {
          "type": "equal_installments",
          "maxTermLength": 2,
          "downPaymentPercentage": 0
        }
      }
    ]
  }'

Responses

Listing update results

Bodyapplication/json
resultsArray of objects
successCountnumber
failureCountnumber
messagestring
signatureRequiredboolean
signatureNotestring
Response
application/json
{ "results": [ {} ], "successCount": 0, "failureCount": 0, "message": "string", "signatureRequired": true, "signatureNote": "string" }

Cancel marketplace listings

Request

Cancel one or more active marketplace listings.

Security
bearerAuth
Bodyapplication/jsonrequired
listingIdsArray of numbers[ 1 .. 50 ] itemsrequired

Array of listing IDs to cancel

curl -i -X POST \
  https://api.unstoppabledomains.com/mcp/v1/actions/ud_listing_cancel \
  -H 'Authorization: Bearer <YOUR_TOKEN_HERE>' \
  -H 'Content-Type: application/json' \
  -d '{
    "listingIds": [
      0
    ]
  }'

Responses

Cancellation results

Bodyapplication/json
resultsArray of objects
successCountnumber
failureCountnumber
messagestring
Response
application/json
{ "results": [ {} ], "successCount": 0, "failureCount": 0, "message": "string" }

List marketplace offers

Request

List incoming offers on domains you own. Filter by domain or status.

Security
bearerAuth
Bodyapplication/jsonrequired
domainNamestring

Filter by specific domain name

groupstring

Filter by group: "active" (pending) or "sold" (completed)

Enum"active""sold"
pagenumber

Page number (1-indexed)

curl -i -X POST \
  https://api.unstoppabledomains.com/mcp/v1/actions/ud_offers_list \
  -H 'Authorization: Bearer <YOUR_TOKEN_HERE>' \
  -H 'Content-Type: application/json' \
  -d '{
    "domainName": "string",
    "group": "active",
    "page": 0
  }'

Responses

List of offers

Bodyapplication/json
offersArray of objects
paginationobject
truncatedboolean

Indicates if the offers list was truncated to meet response size limits

truncationMessagestring

Optional message providing details about the truncation

Response
application/json
{ "offers": [ {} ], "pagination": { "page": 0, "pageSize": 0, "totalPages": 0, "total": 0, "hasMore": true }, "truncated": true, "truncationMessage": "string" }

Respond to marketplace offers

Request

Accept or reject incoming offers on your domains.

Security
bearerAuth
Bodyapplication/jsonrequired
offersArray of objects[ 1 .. 50 ] itemsrequired
offers[].​idnumberrequired

Offer ID

offers[].​actionstringrequired
Enum"accept""reject"
curl -i -X POST \
  https://api.unstoppabledomains.com/mcp/v1/actions/ud_offer_respond \
  -H 'Authorization: Bearer <YOUR_TOKEN_HERE>' \
  -H 'Content-Type: application/json' \
  -d '{
    "offers": [
      {
        "id": 0,
        "action": "accept"
      }
    ]
  }'

Responses

Offer response results

Bodyapplication/json
resultsArray of objects
successCountnumber
failureCountnumber
messagestring
signatureRequiredboolean
signatureNotestring
Response
application/json
{ "results": [ {} ], "successCount": 0, "failureCount": 0, "message": "string", "signatureRequired": true, "signatureNote": "string" }

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