# MCP API Search, check availability, and purchase traditional DNS domains. This API enables AI assistants to help users find and buy domain names. Version: 1.0.0 ## Servers Production server ``` https://api.unstoppabledomains.com ``` ## Security ### bearerAuth API key for authenticated operations. Obtain from your Unstoppable Domains account settings. Type: http Scheme: bearer ## Download OpenAPI description [MCP API](https://docs.unstoppabledomains.com/_bundle/apis/mcp/openapi.yaml) ## Domain Search Search and check domain availability ### Search for available domains or check specific domain availability - [POST /mcp/v1/actions/ud_domains_search](https://docs.unstoppabledomains.com/apis/mcp/openapi/domain-search/domainssearch.md): 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. ### List available TLDs - [POST /mcp/v1/actions/ud_tld_list](https://docs.unstoppabledomains.com/apis/mcp/openapi/domain-search/tldlist.md): List all available ICANN TLDs (top-level domains) supported by our registrar. ## Portfolio Manage owned domains (requires authentication) ### List portfolio domains - [POST /mcp/v1/actions/ud_portfolio_list](https://docs.unstoppabledomains.com/apis/mcp/openapi/portfolio/portfoliolist.md): List domains in the authenticated user's portfolio with filtering, sorting, and pagination. By default, only ICANN (DNS) domains are returned. Returns 50 domains per page by default. If hasMore is true in the pagination response, increment the page parameter to fetch additional results. ### Get comprehensive portfolio domain info - [POST /mcp/v1/actions/ud_domain_get](https://docs.unstoppabledomains.com/apis/mcp/openapi/portfolio/domainget.md): Get comprehensive information for specific domains in your portfolio. Returns all data from ud_portfolio_list plus additional detail: renewal pricing, flags, DNS configuration (nameservers, hosting, DNSSEC), marketplace metrics, and pending operations. Supports bulk lookups for up to 50 domains. ## Contacts Manage ICANN contacts for DNS domain registration (requires authentication) ### List ICANN contacts - [POST /mcp/v1/actions/ud_contacts_list](https://docs.unstoppabledomains.com/apis/mcp/openapi/contacts/contactslist.md): List ICANN contacts configured for the authenticated user's account. Required for DNS domain registration (.com, .org, etc.). ### Create ICANN contact - [POST /mcp/v1/actions/ud_contact_create](https://docs.unstoppabledomains.com/apis/mcp/openapi/contacts/contactcreate.md): Create a new ICANN contact for DNS domain registration. Required for .com, .org, .net, etc. ## Cart Shopping cart management, payment methods, and checkout (requires authentication) ### Get shopping cart with pricing - [POST /mcp/v1/actions/ud_cart_get](https://docs.unstoppabledomains.com/apis/mcp/openapi/cart/cartget.md): Get the current shopping cart contents with comprehensive pricing breakdown including discounts, taxes, and credits. Optionally apply a discount code. Requires authentication. ### Add domains to cart for registration - [POST /mcp/v1/actions/ud_cart_add_domain_registration](https://docs.unstoppabledomains.com/apis/mcp/openapi/cart/cartadddomainregistration.md): Add one or more domains to the shopping cart for fresh registration. Returns the updated cart summary. Requires authentication. ### Add marketplace-listed domains to cart - [POST /mcp/v1/actions/ud_cart_add_domain_listed](https://docs.unstoppabledomains.com/apis/mcp/openapi/cart/cartadddomainlisted.md): 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. ### Add Afternic marketplace domains to cart - [POST /mcp/v1/actions/ud_cart_add_domain_afternic](https://docs.unstoppabledomains.com/apis/mcp/openapi/cart/cartadddomainafternic.md): 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. ### Add Sedo marketplace domains to cart - [POST /mcp/v1/actions/ud_cart_add_domain_sedo](https://docs.unstoppabledomains.com/apis/mcp/openapi/cart/cartadddomainsedo.md): 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. ### Add domain renewals to cart - [POST /mcp/v1/actions/ud_cart_add_domain_renewal](https://docs.unstoppabledomains.com/apis/mcp/openapi/cart/cartadddomainrenewal.md): 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. ### Remove items from cart - [POST /mcp/v1/actions/ud_cart_remove](https://docs.unstoppabledomains.com/apis/mcp/openapi/cart/cartremove.md): Remove one or more items from the shopping cart by product ID. Returns the updated cart. Requires authentication. ### Get available payment methods - [POST /mcp/v1/actions/ud_cart_get_payment_methods](https://docs.unstoppabledomains.com/apis/mcp/openapi/cart/cartgetpaymentmethods.md): Get saved credit cards, account balance, and promo credits available for checkout. Requires authentication. ### Get URL to add a payment method - [POST /mcp/v1/actions/ud_cart_add_payment_method_url](https://docs.unstoppabledomains.com/apis/mcp/openapi/cart/cartaddpaymentmethodurl.md): Get a URL to the payment management page where users can securely add a new credit card. Requires authentication. ### Complete cart checkout - [POST /mcp/v1/actions/ud_cart_checkout](https://docs.unstoppabledomains.com/apis/mcp/openapi/cart/cartcheckout.md): Complete checkout for cart items using saved payment method or account balance. Requires authentication. ### Get checkout URL - [POST /mcp/v1/actions/ud_cart_get_url](https://docs.unstoppabledomains.com/apis/mcp/openapi/cart/cartgeturl.md): Generate a checkout URL for completing the purchase in a browser. Returns the URL along with a cart summary. Requires authentication. ## Marketplace List domains for sale, manage listings, and handle offers (requires authentication) ### Create marketplace listings - [POST /mcp/v1/actions/ud_listing_create](https://docs.unstoppabledomains.com/apis/mcp/openapi/marketplace/listingcreate.md): List one or more domains for sale on the marketplace. Supports buy-now pricing, offers, and lease-to-own options. ### Update marketplace listings - [POST /mcp/v1/actions/ud_listing_update](https://docs.unstoppabledomains.com/apis/mcp/openapi/marketplace/listingupdate.md): Update price, settings, or options for existing listings. ### Cancel marketplace listings - [POST /mcp/v1/actions/ud_listing_cancel](https://docs.unstoppabledomains.com/apis/mcp/openapi/marketplace/listingcancel.md): Cancel one or more active marketplace listings. ### List marketplace offers - [POST /mcp/v1/actions/ud_offers_list](https://docs.unstoppabledomains.com/apis/mcp/openapi/marketplace/offerslist.md): List incoming offers on domains you own. Filter by domain or status. ### Respond to marketplace offers - [POST /mcp/v1/actions/ud_offer_respond](https://docs.unstoppabledomains.com/apis/mcp/openapi/marketplace/offerrespond.md): Accept or reject incoming offers on your domains. ## Leads Domain conversations and messaging between buyers and sellers (requires authentication) ### List domain conversation leads - [POST /mcp/v1/actions/ud_leads_list](https://docs.unstoppabledomains.com/apis/mcp/openapi/leads/leadslist.md): List conversations about domains you own or are interested in. Includes buyer-seller messaging threads. ### Get or create domain conversation - [POST /mcp/v1/actions/ud_lead_get](https://docs.unstoppabledomains.com/apis/mcp/openapi/leads/leadget.md): Start or find an existing conversation with the seller of a domain. Returns existing conversation if one already exists. ### List messages in a conversation - [POST /mcp/v1/actions/ud_lead_messages_list](https://docs.unstoppabledomains.com/apis/mcp/openapi/leads/leadmessageslist.md): Get messages in a domain conversation. Messages are returned newest-first with cursor-based pagination. ### Send a message in a conversation - [POST /mcp/v1/actions/ud_lead_message_send](https://docs.unstoppabledomains.com/apis/mcp/openapi/leads/leadmessagesend.md): Send a message in a domain conversation. Messages are encrypted at rest. ## DNS Management Manage DNS records, nameservers, and hosting configurations for owned domains (requires authentication) ### List DNS records for a domain - [POST /mcp/v1/actions/ud_dns_records_list](https://docs.unstoppabledomains.com/apis/mcp/openapi/dns-management/dnsrecordslist.md): List all DNS records for a domain in your portfolio. Supports filtering by record type and subdomain, with pagination. ### Add DNS records (bulk) - [POST /mcp/v1/actions/ud_dns_record_add](https://docs.unstoppabledomains.com/apis/mcp/openapi/dns-management/dnsrecordadd.md): Add DNS records to one or more domains. Supports A, AAAA, CNAME, MX, TXT, NS, SRV, and CAA record types. Bulk operations up to 50 records. ### Update DNS records (bulk) - [POST /mcp/v1/actions/ud_dns_record_update](https://docs.unstoppabledomains.com/apis/mcp/openapi/dns-management/dnsrecordupdate.md): Update existing DNS records on one or more domains. Bulk operations up to 50 records. ### Remove DNS records (bulk) - [POST /mcp/v1/actions/ud_dns_record_remove](https://docs.unstoppabledomains.com/apis/mcp/openapi/dns-management/dnsrecordremove.md): Remove specific DNS records by ID from one or more domains. Bulk operations up to 50 records. ### Remove all DNS records (bulk) - [POST /mcp/v1/actions/ud_dns_records_remove_all](https://docs.unstoppabledomains.com/apis/mcp/openapi/dns-management/dnsrecordsremoveall.md): Remove ALL user-created DNS records from one or more domains. Requires explicit confirmation. Bulk operations up to 50 domains. ### List nameservers for a domain - [POST /mcp/v1/actions/ud_dns_nameservers_list](https://docs.unstoppabledomains.com/apis/mcp/openapi/dns-management/dnsnameserverslist.md): List current nameservers and check if using UD defaults or custom nameservers. ### Set custom nameservers (bulk) - [POST /mcp/v1/actions/ud_dns_nameservers_set_custom](https://docs.unstoppabledomains.com/apis/mcp/openapi/dns-management/dnsnameserverssetcustom.md): Configure external nameservers (e.g., Cloudflare, Route 53) for one or more domains. Supports up to 50 domains per request. ### Reset to UD default nameservers (bulk) - [POST /mcp/v1/actions/ud_dns_nameservers_set_default](https://docs.unstoppabledomains.com/apis/mcp/openapi/dns-management/dnsnameserverssetdefault.md): Switch back to Unstoppable Domains default nameservers for one or more domains. Supports up to 50 domains per request. ### List hosting configurations - [POST /mcp/v1/actions/ud_dns_hosting_list](https://docs.unstoppabledomains.com/apis/mcp/openapi/dns-management/dnshostinglist.md): List hosting/forwarding configurations (UD Profile, redirects). ### Add hosting configuration (bulk) - [POST /mcp/v1/actions/ud_dns_hosting_add](https://docs.unstoppabledomains.com/apis/mcp/openapi/dns-management/dnshostingadd.md): Configure hosting for one or more domains: for-sale listing page, permanent redirect (301), or temporary redirect (302). Supports up to 50 domains per request. ### Remove hosting configuration (bulk) - [POST /mcp/v1/actions/ud_dns_hosting_remove](https://docs.unstoppabledomains.com/apis/mcp/openapi/dns-management/dnshostingremove.md): Remove hosting/forwarding configuration from one or more domains. Supports up to 50 domains per request. ### Get pending operations for multiple domains - [POST /mcp/v1/actions/ud_domain_pending_operations](https://docs.unstoppabledomains.com/apis/mcp/openapi/dns-management/domainpendingoperations.md): Check status of DNS operations across multiple domains. Use to track changes and verify completion after bulk operations. ## Domain Management Manage domain settings like auto renewal (requires authentication) ### Enable or disable auto renewal for ICANN DNS domains - [POST /mcp/v1/actions/ud_domain_auto_renewal_update](https://docs.unstoppabledomains.com/apis/mcp/openapi/domain-management/domainautorenewalupdate.md): Enable or disable auto renewal for ICANN DNS domains (.com, .net, .org, .io, etc.). When enabled, domains will be automatically renewed before expiration using the saved payment method. User must own the domains and have a valid payment method on file. Use ud_cart_get_payment_methods to retrieve available payment methods. ### Add tags to domains - [POST /mcp/v1/actions/ud_domain_tags_add](https://docs.unstoppabledomains.com/apis/mcp/openapi/domain-management/domaintagsadd.md): Add tags to domains in your portfolio. Creates new tags automatically if they don't exist. Supports bulk operations for up to 50 domains. ### Remove tags from domains - [POST /mcp/v1/actions/ud_domain_tags_remove](https://docs.unstoppabledomains.com/apis/mcp/openapi/domain-management/domaintagsremove.md): Remove tags from domains in your portfolio. Supports bulk operations for up to 50 domains. ### Update domain flags - [POST /mcp/v1/actions/ud_domain_flags_update](https://docs.unstoppabledomains.com/apis/mcp/openapi/domain-management/domainflagsupdate.md): Update domain flags (WHOIS privacy, transfer lock) for domains in your portfolio. Supports bulk operations for up to 50 domains. ### Push domains to another user - [POST /mcp/v1/actions/ud_domain_push](https://docs.unstoppabledomains.com/apis/mcp/openapi/domain-management/domainpush.md): Push domains to another Unstoppable Domains user. Requires MFA (two-factor authentication) verification. The recipient must accept the transfer.