Skip to main content

Hostinger Domains Check Domain Availability V1

Immutable Catalog Entry

This descriptor comes from the active versioned Portal catalog.

READhostinger.domains_checkDomainAvailabilityV1
  • Contract tier: agent_ready
  • Risk: read
  • Catalog version: hostinger-2026.07.12.1
  • Descriptor hash: e0b8c56799da29857b0a6bc77592f15cbfaa5ab0acaedd362d7af28b10c58825

Use this tool when you need the Hostinger operation Check domain availability. Check availability of domain names across multiple TLDs. Multiple TLDs can be checked at once. If you want alternative domains with response, provide only one TLD and set with_alternatives to true. TLDs should be provided without leading dot (e.g. com, net, org). Endpoint has rate limit of 10 requests per minute. Use this endpoint to verify domain availability before purchase. It calls POST /api/domains/v1/availability against the configured Hostinger account. This reads external Hostinger account state and does not modify it. Provider parameters: This operation has no path or query parameters. The body follows the complete Hostinger schema in inputSchema. Do not place API tokens in arguments; credentials arrive only through protected Portal headers. The result is the normalized Hostinger MCP envelope with data, safe error details, HTTP/rate metadata, and pagination metadata when available. Runtime summary: Use this when you need Hostinger API operation domains_checkDomainAvailabilityV1: Check domain availability. Check availability of domain names across multiple TLDs. Multiple TLDs can be checked at once. If you want alternative domains with response, provide only one TLD and set with_alternatives to true. TLDs should be provided without leading dot (e.g. com, net, org). Endpoint has rate limit of 10 requests per minute. Use this endpoint to verify domain availability before purchase. Endpoint: POST /api/domains/v1/availability. Path params: none. Request body: required/accepted. Risk class: read. This write tool requires confirm=true. Returns the compact MAD envelope {ok,data,error,meta}; set dry_run=true to preview without calling Hostinger.

Request Body​

{
  "jsonrpc": "2.0",
  "id": "hostinger-domains-checkdomainavailabilityv1-example",
  "method": "tools/call",
  "params": {
    "name": "hostinger.domains_checkDomainAvailabilityV1",
    "arguments": {
      "body": "",
      "params": "",
      "compact": "",
      "confirm": false,
      "dry_run": false,
      "max_items": "",
      "include_raw": false,
      "path_params": "",
      "confirmation_phrase": ""
    }
  }
}

Arguments Schema​

{
  "type": "object",
  "required": [
    "body"
  ],
  "properties": {
    "body": {
      "anyOf": [
        {
          "type": "object",
          "required": [
            "domain",
            "tlds"
          ],
          "properties": {
            "tlds": {
              "type": "array",
              "items": {
                "type": "string",
                "description": "TLD without leading dot"
              },
              "description": "TLDs list"
            },
            "domain": {
              "type": "string",
              "description": "Domain name (without TLD)"
            },
            "with_alternatives": {
              "type": "boolean",
              "description": "Should response include alternatives"
            }
          }
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "JSON request body using the complete checked-in Hostinger provider schema."
    },
    "params": {
      "anyOf": [
        {
          "type": "object",
          "properties": {},
          "additionalProperties": false
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Exact query parameters for this Hostinger operation, keyed by the provider names shown here."
    },
    "compact": {
      "anyOf": [
        {
          "type": "boolean"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "When true, truncate large arrays using MCP_MAX_ITEMS_* limits."
    },
    "confirm": {
      "type": "boolean",
      "default": false,
      "description": "Required as true for any Hostinger write, spend, or destructive call."
    },
    "dry_run": {
      "type": "boolean",
      "default": false,
      "description": "Preview the request and risk gates without calling Hostinger."
    },
    "max_items": {
      "anyOf": [
        {
          "type": "integer"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Maximum array items to keep when compacting responses."
    },
    "include_raw": {
      "type": "boolean",
      "default": false,
      "description": "When true, include raw Hostinger response alongside normalized data."
    },
    "path_params": {
      "anyOf": [
        {
          "type": "object",
          "properties": {},
          "additionalProperties": false
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Exact path parameters for this Hostinger operation, keyed by the provider names shown here."
    },
    "confirmation_phrase": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Required exact phrase for spend, credential, and destructive tools."
    }
  },
  "additionalProperties": false
}

Output Schema​

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "ok",
    "data",
    "error",
    "meta"
  ],
  "properties": {
    "ok": {
      "type": "boolean",
      "description": "True only when the requested Hostinger or local catalog operation succeeded."
    },
    "data": {
      "description": "Normalized result data, or null when the operation failed."
    },
    "meta": {
      "type": "object",
      "description": "Safe endpoint, timing, pagination, rate, catalog, and next-action metadata.",
      "additionalProperties": true
    },
    "error": {
      "description": "Secret-safe structured error details, or null on success."
    }
  },
  "description": "Normalized Hostinger MCP response envelope.",
  "additionalProperties": false
}

Code Examples​

curl -X POST 'https://portal.madpanda3d.com/api/mcp' \
  -H 'Authorization: Bearer mad_live_***' \
  -H 'Content-Type: application/json' \
  -d '{
  "jsonrpc": "2.0",
  "id": "hostinger-domains-checkdomainavailabilityv1-example",
  "method": "tools/call",
  "params": {
    "name": "hostinger.domains_checkDomainAvailabilityV1",
    "arguments": {
      "body": "",
      "params": "",
      "compact": "",
      "confirm": false,
      "dry_run": false,
      "max_items": "",
      "include_raw": false,
      "path_params": "",
      "confirmation_phrase": ""
    }
  }
}'

Example Responses​

{
  "ok": true,
  "message": "Tool hostinger.domains_checkDomainAvailabilityV1 executed successfully.",
  "note": "Response shape varies by MCP tool. Inspect live responses for exact fields."
}