Site lifecycle

check_slug_available

Check whether a subdomain slug is free for this account. Slugs are 1..63 chars of lowercase letters, digits and hyphens, starting and ending alphanumeric, and must not be reserved. With site_id, the site's own slug counts as available. Unavailable results carry reason 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 56 Sentway tools. See connecting over MCP.