Skip to content
MCP/
/
Get URL to add a payment...

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

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

Get shopping cart with pricing

Request

Get the current shopping cart contents with comprehensive pricing breakdown including discounts, taxes, and credits. Optionally apply a discount code. Requires authentication.

Security
bearerAuth
Bodyapplication/jsonrequired
discountCodestring

Optional discount/promo code to apply

curl -i -X POST \
  https://api.unstoppabledomains.com/mcp/v1/actions/ud_cart_get \
  -H 'Authorization: Bearer <YOUR_TOKEN_HERE>' \
  -H 'Content-Type: application/json' \
  -d '{
    "discountCode": "string"
  }'

Responses

Cart contents with pricing

Bodyapplication/json
itemsArray of objects(CartItem)
itemCountnumber
pricingobject
discountsArray of objects
totalDiscountsnumber
totalDiscountsFormattedstring
Response
application/json
{
  "items": [
    { … }
  ],
  "itemCount": 0,
  "pricing": {
    "totalOrderValue": 0,
    "totalOrderValueFormatted": "string",
    "preTaxAmountDue": 0,
    "preTaxAmountDueFormatted": "string",
    "salesTax": 0,
    "salesTaxFormatted": "string",
    "taxRate": 0,
    "promoCreditsUsed": 0,
    "promoCreditsUsedFormatted": "string",
    "storeCreditsUsed": 0,
    "storeCreditsUsedFormatted": "string",
    "accountBalanceUsed": 0,
    "accountBalanceUsedFormatted": "string",
    "totalAmountDue": 0,
    "totalAmountDueFormatted": "string"
  },
  "discounts": [
    { … }
  ],
  "totalDiscounts": 0,
  "totalDiscountsFormatted": "string"
}

Add domains to cart for registration

Request

Add one or more domains to the shopping cart for fresh registration. Returns the updated cart summary. Requires authentication.

Security
bearerAuth
Bodyapplication/jsonrequired
domainsArray of objectsnon-emptyrequired

Array of domains to add to the cart

domains[].​namestringrequired

Full domain name (e.g., "example.com")

domains[].​productTypestring

Product type (default: Domain)

domains[].​quantityinteger[ 1 .. 10 ]

Registration years (1-10, default: 1)

curl -i -X POST \
  https://api.unstoppabledomains.com/mcp/v1/actions/ud_cart_add_domain_registration \
  -H 'Authorization: Bearer <YOUR_TOKEN_HERE>' \
  -H 'Content-Type: application/json' \
  -d '{
    "domains": [
      {
        "name": "string",
        "productType": "string",
        "quantity": 1
      }
    ]
  }'

Responses

Updated cart

Bodyapplication/json
addedProductsArray of objects
successCountnumber
failureCountnumber
cartobject
Response
application/json
{
  "addedProducts": [
    { … }
  ],
  "successCount": 0,
  "failureCount": 0,
  "cart": {
    "itemCount": 0,
    "subtotal": 0,
    "subtotalFormatted": "string"
  }
}

Add marketplace-listed domains to cart

Request

Add one or more marketplace-listed domains to the shopping cart. Supports both "Buy it now" (full price) and "Lease to Own" (monthly payments) purchases. Requires authentication.

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

Array of marketplace-listed domains to add to cart

domains[].​namestringrequired

Full domain name listed on marketplace (e.g., "premium.com")

domains[].​leaseToOwnOptionsobject

Optional lease-to-own options. Omit for immediate "Buy it now" purchase.

curl -i -X POST \
  https://api.unstoppabledomains.com/mcp/v1/actions/ud_cart_add_domain_listed \
  -H 'Authorization: Bearer <YOUR_TOKEN_HERE>' \
  -H 'Content-Type: application/json' \
  -d '{
    "domains": [
      {
        "name": "string",
        "leaseToOwnOptions": {
          "type": "equal_installments",
          "termLength": 2,
          "downPaymentPercentage": 10
        }
      }
    ]
  }'

Responses

Updated cart with listed domains

Bodyapplication/json
addedProductsArray of objects
successCountnumber
failureCountnumber
cartobject
Response
application/json
{
  "addedProducts": [
    { … }
  ],
  "successCount": 0,
  "failureCount": 0,
  "cart": {
    "itemCount": 0,
    "subtotal": 0,
    "subtotalFormatted": "string"
  }
}

Add Afternic marketplace domains to cart

Request

Add one or more Afternic marketplace domains to the shopping cart. For domains with marketplace.source = "afternic" and marketplace.status = "registered-listed-for-sale" from search results. Requires authentication.

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

Array of Afternic marketplace domains to add to cart

domains[].​namestringrequired

Full domain name from Afternic marketplace (e.g., "premium.com")

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

Responses

Updated cart with Afternic domains

Bodyapplication/json
addedProductsArray of objects
successCountnumber
failureCountnumber
cartobject
Response
application/json
{
  "addedProducts": [
    { … }
  ],
  "successCount": 0,
  "failureCount": 0,
  "cart": {
    "itemCount": 0,
    "subtotal": 0,
    "subtotalFormatted": "string"
  }
}

Add Sedo marketplace domains to cart

Request

Add one or more Sedo marketplace domains to the shopping cart. For domains with marketplace.source = "sedo" and marketplace.status = "registered-listed-for-sale" from search results. Requires authentication.

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

Array of Sedo marketplace domains to add to cart

domains[].​namestringrequired

Full domain name from Sedo marketplace (e.g., "premium.com")

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

Responses

Updated cart with Sedo domains

Bodyapplication/json
addedProductsArray of objects
successCountnumber
failureCountnumber
cartobject
Response
application/json
{
  "addedProducts": [
    { … }
  ],
  "successCount": 0,
  "failureCount": 0,
  "cart": {
    "itemCount": 0,
    "subtotal": 0,
    "subtotalFormatted": "string"
  }
}

Add domain renewals to cart

Request

Add one or more domain renewals to the shopping cart. User must own the domains to renew them. Returns the updated cart summary. Requires authentication.

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

Array of domains to add renewal to cart

domains[].​namestringrequired

Full domain name to renew (e.g., "example.com")

domains[].​quantityinteger[ 1 .. 10 ]

Renewal period in years (1-10, default: 1)

curl -i -X POST \
  https://api.unstoppabledomains.com/mcp/v1/actions/ud_cart_add_domain_renewal \
  -H 'Authorization: Bearer <YOUR_TOKEN_HERE>' \
  -H 'Content-Type: application/json' \
  -d '{
    "domains": [
      {
        "name": "string",
        "quantity": 1
      }
    ]
  }'

Responses

Updated cart with renewals

Bodyapplication/json
addedRenewalsArray of objects
successCountnumber
failureCountnumber
cartobject
Response
application/json
{
  "addedRenewals": [
    { … }
  ],
  "successCount": 0,
  "failureCount": 0,
  "cart": {
    "itemCount": 0,
    "subtotal": 0,
    "subtotalFormatted": "string"
  }
}

Remove items from cart

Request

Remove one or more items from the shopping cart by product ID. Returns the updated cart. Requires authentication.

Security
bearerAuth
Bodyapplication/jsonrequired
productIdsArray of numbersnon-emptyrequired

Array of product IDs to remove from the cart

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

Responses

Updated cart

Bodyapplication/json
removedProductIdsArray of numbers
removedCountnumber
cartobject
Response
application/json
{
  "removedProductIds": [
    0
  ],
  "removedCount": 0,
  "cart": {
    "itemCount": 0,
    "subtotal": 0,
    "subtotalFormatted": "string",
    "items": [ … ]
  }
}

Get available payment methods

Request

Get saved credit cards, account balance, and promo credits available for checkout. Requires authentication.

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

Responses

Payment methods

Bodyapplication/json
savedCardsArray of objects
accountBalanceobject
promoCreditsobject
summaryobject
Response
application/json
{
  "savedCards": [
    { … }
  ],
  "accountBalance": {
    "amount": 0,
    "amountFormatted": "string"
  },
  "promoCredits": {
    "amount": 0,
    "amountFormatted": "string"
  },
  "summary": {
    "hasValidCards": true,
    "validCardCount": 0,
    "hasAccountBalance": true,
    "hasPromoCredits": true,
    "totalCredits": 0,
    "totalCreditsFormatted": "string",
    "canCheckout": true
  }
}

Get URL to add a payment method

Request

Get a URL to the payment management page where users can securely add a new credit card. Requires authentication.

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

Responses

Add payment method URL

Bodyapplication/json
urlstring

URL to the payment management page

instructionsstring

Guidance for the user on how to add a card

Response
application/json
{
  "url": "string",
  "instructions": "string"
}

Complete cart checkout

Request

Complete checkout for cart items using saved payment method or account balance. Requires authentication.

Security
bearerAuth
Bodyapplication/jsonrequired
paymentMethodIdstring

Stripe payment method ID for card payment. Required if cart total exceeds account balance.

useAccountBalanceboolean

Whether to apply account balance to reduce total. Defaults to true.

discountCodestring

Optional discount/promo code to apply

contactIdstring

ICANN contact ID for DNS domain registration. Get IDs from ud_contacts_list. If not specified, uses the most recent contact.

curl -i -X POST \
  https://api.unstoppabledomains.com/mcp/v1/actions/ud_cart_checkout \
  -H 'Authorization: Bearer <YOUR_TOKEN_HERE>' \
  -H 'Content-Type: application/json' \
  -d '{
    "paymentMethodId": "string",
    "useAccountBalance": true,
    "discountCode": "string",
    "contactId": "string"
  }'

Responses

Checkout result

Bodyapplication/json
successboolean
orderIdnumber
paymentIdnumber
summaryobject
notestring

Optional note about contact selection when user has multiple contacts

Response
application/json
{
  "success": true,
  "orderId": 0,
  "paymentId": 0,
  "summary": {
    "itemCount": 0,
    "domains": [ … ],
    "subtotal": 0,
    "subtotalFormatted": "string",
    "discounts": 0,
    "discountsFormatted": "string",
    "creditsUsed": 0,
    "creditsUsedFormatted": "string",
    "salesTax": 0,
    "salesTaxFormatted": "string",
    "totalCharged": 0,
    "totalChargedFormatted": "string",
    "paymentMethod": "string"
  },
  "note": "string"
}

Get checkout URL

Request

Generate a checkout URL for completing the purchase in a browser. Returns the URL along with a cart summary. Requires authentication.

Security
bearerAuth
Bodyapplication/jsonrequired
discountCodestring

Optional discount/promo code to include in checkout URL

curl -i -X POST \
  https://api.unstoppabledomains.com/mcp/v1/actions/ud_cart_get_url \
  -H 'Authorization: Bearer <YOUR_TOKEN_HERE>' \
  -H 'Content-Type: application/json' \
  -d '{
    "discountCode": "string"
  }'

Responses

Checkout URL and cart summary

Bodyapplication/json
checkoutUrlstring
cartSummaryobject
discountCodestring or null
instructionsstring
Response
application/json
{
  "checkoutUrl": "string",
  "cartSummary": {
    "itemCount": 0,
    "subtotal": 0,
    "subtotalFormatted": "string",
    "items": [ … ]
  },
  "discountCode": "string",
  "instructions": "string"
}

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