Tool Reference

The Entri MCP server exposes the following tools. For feedback or to request additional tools, contact support@entri.com.

Tool	Description
`search-domain-availability`	Check if a domain is available for registration. Returns availability, price, and renewal price.
`generate-domain-suggestions`	Generate AI-powered domain name suggestions from keywords or a business description.
`create-domain-order`	Initiate a domain purchase flow. Returns a sharing link the user follows to complete checkout through the registrar.
`connect-domain`	Generate a guided DNS configuration link for the user to connect an existing domain to your platform.
`check-connection-status`	Check DNS propagation and connection status using the `jobId` returned by `connect-domain`.
`check-order-status`	Check the current status of a domain purchase order using the `jobId` from `create-domain-order`.

Tool: search-domain-availability

Checks whether a domain is available for registration, along with its registration and renewal pricing. Example:

User: "Is startup.ai available?"
AI calls: search-domain-availability(domain: "startup.ai")

Response (available):

{
  "domain": "startup.ai",
  "available": true,
  "price": "$49.99/year",
  "renewalPrice": "$89.99/year",
  "message": "startup.ai is available!"
}

Response (unavailable):

{
  "domain": "startup.ai",
  "available": false,
  "message": "startup.ai is taken."
}

Tool: generate-domain-suggestions

Generates AI-powered domain name suggestions based on keywords or a business description. Returns only available domains, sorted by relevance. Always returns a minimum of 5 suggestions. The top recommendation is marked with 🏆. Example:

User: "Suggest domains for my AI coding assistant startup"
AI calls: generate-domain-suggestions(keywords: "AI coding assistant startup", limit: 5)

Response:

{
  "keywords": "AI coding assistant startup",
  "suggestions": [
    {
      "domain": "🏆 codecopilot.shop",
      "price": "$12.99/year",
      "renewalPrice": "$24.99/year"
    },
    {
      "domain": "codecopilot.ai",
      "price": "$49.99/year",
      "renewalPrice": "$89.99/year"
    },
    {
      "domain": "aicode.dev",
      "price": "$29.99/year",
      "renewalPrice": "$39.99/year"
    }
  ],
  "count": 3,
  "message": "Display these domain suggestions in a table with columns: Domain, Price, Renewal Price. The first domain (marked with 🏆) is the recommended option."
}

Tool: create-domain-order

Initiates a domain purchase flow. Returns a sharing link the user follows to complete checkout through the registrar (IONOS, Squarespace, or GoDaddy) — see How Each Product Works via MCP. Example:

User: "Register startup.ai for me"
AI calls: create-domain-order(domain: "startup.ai")

Response — Sharing registrar (IONOS / Squarespace / GoDaddy):

{
  "success": true,
  "domain": "startup.ai",
  "link": "https://connect.entri.com/sell-flow?token=abc123...",
  "jobId": "JOB-1707000000-abc123",
  "message": "Sharing purchase link for startup.ai — Present this link to the user and ask them to complete the purchase. Then use check-order-status with jobId \"JOB-1707000000-abc123\" to track progress."
}

Response — Error:

{
  "success": false,
  "domain": "startup.ai",
  "error": "HTTP 422",
  "message": "The domain startup.ai could not be ordered."
}

Important notes:

The AI agent must present the link to the user and ask them to complete the purchase. The purchase is completed by the user in the registrar’s checkout — the agent cannot complete it on their behalf.
dnsRecords is not a parameter of this tool. DNS records are configured via your MCP Settings (Static or Dynamic).
After a successful order, always poll check-order-status with the returned jobId until the purchase is complete.

Registrar	Response	Next step
IONOS / Squarespace / GoDaddy	Returns `link` + `jobId`	Present link to user, then poll `check-order-status` with `jobId`

Tool: connect-domain

Generates a guided DNS configuration link for an existing domain. The user must open this link to complete the DNS setup through Entri’s connection flow. Example:

User: "Connect startup.ai to my project"
AI calls: connect-domain(domain: "startup.ai")

Response (success):

{
  "success": true,
  "domain": "startup.ai",
  "link": "https://connect.entri.com/flow?token=abc123...",
  "jobId": "JOB-1707000000-abc123",
  "message": "Connect flow link for startup.ai: https://connect.entri.com/flow?token=abc123..."
}

Response (error):

{
  "success": false,
  "domain": "startup.ai",
  "error": "HTTP 404",
  "message": "The domain startup.ai could not be found in your account."
}

Important notes:

The AI agent must present the returned link to the user and ask them to open it. The DNS setup is completed by the user in Entri’s flow — the agent cannot complete it on their behalf.
After the user opens the link, use check-connection-status with the returned jobId to monitor DNS propagation.
DNS propagation can take up to 48 hours in rare cases.

Tool: check-connection-status

Retrieves the current DNS propagation and connection status for a domain. Use it after connect-domain to verify whether DNS records have fully propagated. Example:

User: "Is startup.ai fully connected yet?"
AI calls: check-connection-status(jobId: "JOB-1707000000-abc123")

Response (connected):

{
  "jobId": "JOB-1707000000-abc123",
  "connected": true,
  "status": "completed",
  "domain": "startup.ai",
  "message": "DNS configuration complete! Domain startup.ai is now connected."
}

Response (in progress):

{
  "jobId": "JOB-1707000000-abc123",
  "connected": false,
  "status": "pending",
  "domain": "startup.ai",
  "message": "Connection JOB-1707000000-abc123 is still in progress (status: pending). Check again shortly."
}

Response (failed):

{
  "jobId": "JOB-1707000000-abc123",
  "connected": false,
  "status": "failed",
  "message": "Connection JOB-1707000000-abc123 has failed with status: failed."
}

Status values:

Status	Meaning
`pending`	User hasn’t completed the flow yet
`completed`	DNS fully propagated and connected
`failed`	Connection failed
`error`	Unexpected error
`expired`	The connect link expired before use

Tool: check-order-status

Retrieves the current processing status of a domain purchase order. Use it after create-domain-order to track progress. Example:

User: "What's the status of my domain purchase?"
AI calls: check-order-status(jobId: "JOB-1707000000-abc123")

Response (completed):

{
  "jobId": "JOB-1707000000-abc123",
  "status": "completed",
  "domains": [
    { "domain": "startup.ai", "status": "registered" }
  ],
  "message": "Order JOB-1707000000-abc123 is complete."
}

Response (in progress):

{
  "jobId": "JOB-1707000000-abc123",
  "status": "pending",
  "message": "Order JOB-1707000000-abc123 is still in progress (status: pending). Check again shortly."
}

Response (failed):

{
  "jobId": "JOB-1707000000-abc123",
  "status": "failed",
  "message": "Order JOB-1707000000-abc123 has failed with status: failed."
}

Status values:

Status	Meaning
`pending`	Purchase queued, not yet processed
`in_progress`	Purchase actively being processed
`completed`	Purchase completed and domain registered
`failed`	Purchase failed
`cancelled`	Order was cancelled
`rejected`	Order was rejected
`error`	Unexpected error occurred
`expired`	Sharing link expired before use

Get Started

Activate Suite

Domain Management

SSL Provisioning

For DNS Providers

DNS Concepts

Entri MCP

Reference

Legal & Security

Resources

Tool Reference

Tool: search-domain-availability

Tool: generate-domain-suggestions

Tool: create-domain-order

Tool: connect-domain

Tool: check-connection-status

Tool: check-order-status

​Tool: search-domain-availability

​Tool: generate-domain-suggestions

​Tool: create-domain-order

​Tool: connect-domain

​Tool: check-connection-status

​Tool: check-order-status

Tool: search-domain-availability

Tool: generate-domain-suggestions

Tool: create-domain-order

Tool: connect-domain

Tool: check-connection-status

Tool: check-order-status