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

Leads

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

Operations

List domain conversation leads

Request

List conversations about domains you own or are interested in. Includes buyer-seller messaging threads.

Security
bearerAuth
Bodyapplication/jsonrequired
domainstring

Filter by specific domain name (e.g., "example.crypto")

skipEmptyboolean

Skip conversations with no messages (default: true)

Default true
skipinteger>= 0

Number of conversations to skip (pagination offset, default: 0)

Default 0
takeinteger[ 1 .. 100 ]

Number of conversations to return (1-100, default: 20)

Default 20
curl -i -X POST \
  https://api.unstoppabledomains.com/mcp/v1/actions/ud_leads_list \
  -H 'Authorization: Bearer <YOUR_TOKEN_HERE>' \
  -H 'Content-Type: application/json' \
  -d '{
    "domain": "string",
    "skipEmpty": true,
    "skip": 0,
    "take": 20
  }'

Responses

List of conversations

Bodyapplication/json
leadsArray of objects
totalnumber

Total number of conversations matching filters

skipnumber

Number of items skipped

takenumber

Number of items returned

Response
application/json
{ "leads": [ {} ], "total": 0, "skip": 0, "take": 0 }

Get or create domain conversation

Request

Start or find an existing conversation with the seller of a domain. Returns existing conversation if one already exists.

Security
bearerAuth
Bodyapplication/jsonrequired
domainstringrequired

The domain name to inquire about (e.g., "example.crypto")

buyerIdstring

Optional: Encoded buyer ID for sellers responding to offers

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

Responses

Conversation details

Bodyapplication/json
conversationobject
messagestring
Response
application/json
{ "conversation": { "id": 0, "domainName": "string", "domainId": 0, "createdAt": "string", "participants": [], "isExisting": true }, "message": "string" }

List messages in a conversation

Request

Get messages in a domain conversation. Messages are returned newest-first with cursor-based pagination.

Security
bearerAuth
Bodyapplication/jsonrequired
conversationIdnumberrequired

The conversation ID

cursorstring

Pagination cursor for loading older messages

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

Responses

List of messages

Bodyapplication/json
messagesArray of objects
hasMoreboolean
nextCursorstring or null
conversationIdnumber
Response
application/json
{ "messages": [ {} ], "hasMore": true, "nextCursor": "string", "conversationId": 0 }

Send a message in a conversation

Request

Send a message in a domain conversation. Messages are encrypted at rest.

Security
bearerAuth
Bodyapplication/jsonrequired
conversationIdnumberrequired

The conversation ID

contentstring<= 1000 charactersrequired

Message content (1-1000 characters)

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

Responses

Sent message details

Bodyapplication/json
messageobject
conversationIdnumber
Response
application/json
{ "message": { "id": 0, "content": "string", "senderUserId": 0, "createdAt": "string" }, "conversationId": 0 }

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