Skip to content
/Portfolio

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

List portfolio domains

Request

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.

Security
bearerAuth
Bodyapplication/jsonrequired
pagenumber>= 1

Page number, 1-indexed (default: 1)

Example: 1
pageSizenumber[ 1 .. 100 ]

Number of domains per page, 1-100 (default: 50)

Example: 50
searchTermstring

Optional search term to filter domains by name

statusstring

Filter by listing status: "all" (default), "for-sale", or "unlisted"

Enum"all""for-sale""unlisted"
registryTypestring

Filter by registry type: "dns" (ICANN/Web2 domains, default) or "web3" (blockchain domains only)

Enum"dns""web3"
expiringWithinDaysnumber[ 1 .. 365 ]

Filter domains expiring within the specified number of days (1-365)

Example: 30
expiredboolean

Filter for domains that have already expired

minLengthnumber>= 1

Filter domains with label length >= this value

maxLengthnumber>= 1

Filter domains with label length <= this value

autoRenewalstring

Filter by auto-renewal status

Enum"true""false"
tagFiltersArray of strings

Filter domains by tag names (e.g., ["personal", "business"])

orderBystring

Sort by: "name", "length", "purchasedAt", "expiresAt", "listingPrice", "offers", "leads", or "watchlistCount"

Enum"name""length""purchasedAt""expiresAt""listingPrice""offers""leads""watchlistCount"
orderDirectionstring

Sort direction: "asc" (ascending, default) or "desc" (descending)

Enum"asc""desc"
curl -i -X POST \
  https://api.unstoppabledomains.com/mcp/v1/actions/ud_portfolio_list \
  -H 'Authorization: Bearer <YOUR_TOKEN_HERE>' \
  -H 'Content-Type: application/json' \
  -d '{
    "page": 1,
    "pageSize": 50,
    "searchTerm": "string",
    "status": "all",
    "registryType": "dns",
    "expiringWithinDays": 30,
    "expired": true,
    "minLength": 1,
    "maxLength": 1,
    "autoRenewal": "true",
    "tagFilters": [
      "string"
    ],
    "orderBy": "name",
    "orderDirection": "asc"
  }'

Responses

Portfolio domains list

Bodyapplication/json
domainsArray of objects(PortfolioDomain)
paginationobject
truncatedboolean

Whether results were truncated due to size limits

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

Get comprehensive portfolio domain info

Request

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.

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

Array of domain names to get info for (e.g., ["example.com", "mysite.io"])

Example: ["example.com","mysite.io"]
curl -i -X POST \
  https://api.unstoppabledomains.com/mcp/v1/actions/ud_domain_get \
  -H 'Authorization: Bearer <YOUR_TOKEN_HERE>' \
  -H 'Content-Type: application/json' \
  -d '{
    "domains": [
      "example.com",
      "mysite.io"
    ]
  }'

Responses

Portfolio domain details

Bodyapplication/json
domainsArray of objects

Comprehensive info for each requested domain

availableTagsArray of strings

All tags you've created (useful for adding tags to other domains)

Response
application/json
{
  "domains": [
    { … }
  ],
  "availableTags": [
    "string"
  ]
}

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