Site lifecycle

check_slug_available

Check whether a subdomain slug is available for a site in the caller's account. Slugs must be lowercase letters, digits and hyphens, 1..63 characters, starting and ending with a letter or digit, and must not collide with Sentway's reserved names. When site_id is supplied, the site's own current slug is treated as available (same-site reclaim). Returns { available: true, slug } or { available: false, slug, reason, message } where reason is one of invalid / reserved / taken / retired. Read-only.

Behaviour

Effect: Read only. Calling it never changes anything in the account.
Repeat calls: Idempotent. Repeating the same call produces the same result.
Plan: Available on every plan, including free.

Parameters

Name	Type	Required	Description
slug	string	Yes	Subdomain label: lowercase letters, digits and hyphens; 1..63 chars.
site_id	uuid	No	—

Returns

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "oneOf": [
    {
      "type": "object",
      "properties": {
        "available": {
          "type": "boolean",
          "const": true
        },
        "slug": {
          "type": "string"
        }
      },
      "required": [
        "available",
        "slug"
      ],
      "additionalProperties": false
    },
    {
      "type": "object",
      "properties": {
        "available": {
          "type": "boolean",
          "const": false
        },
        "slug": {
          "type": "string"
        },
        "reason": {
          "type": "string",
          "enum": [
            "invalid",
            "reserved",
            "taken",
            "retired"
          ]
        },
        "message": {
          "type": "string",
          "maxLength": 300
        }
      },
      "required": [
        "available",
        "slug",
        "reason",
        "message"
      ],
      "additionalProperties": false
    }
  ],
  "type": "object"
}

Using it

check_slug_available is called by an AI assistant connected to Sentway over MCP, not by hand. Point the assistant at the Sentway MCP endpoint and complete the OAuth flow, and the tool becomes available in the same session as the other 38 Sentway tools. See connecting over MCP.