Hostinger Domains Purchase New Domain V1

Immutable Catalog Entry

This descriptor comes from the active versioned Portal catalog.

DESTRUCTIVEhostinger.domains_purchaseNewDomainV1

• Contract tier: agent_ready
• Risk: destructive
• Catalog version: hostinger-2026.07.12.1
• Descriptor hash: 09e3030eb5a6984358c51c7096f9a182bb46ddaa1ff13fcc210fece9388cc7d1

Use this tool when you need the Hostinger operation Purchase new domain. Purchase and register a new domain name. If registration fails, login to hPanel and check domain registration status. If no payment method is provided, your default payment method will be used automatically. If no WHOIS information is provided, default contact information for that TLD will be used. Before making request, ensure WHOIS information for desired TLD exists in your account. Some TLDs require additional_details to be provided and these will be validated before completing purchase. Use this endpoint to register new domains for users. It calls POST /api/domains/v1/portfolio against the configured Hostinger account. This can delete, overwrite, change credentials, or spend money and requires both the declared confirmation controls and a Portal destructive preview. 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_purchaseNewDomainV1: Purchase new domain. Purchase and register a new domain name. If registration fails, login to hPanel and check domain registration status. If no payment method is provided, your default payment method will be used automatically. If no WHOIS information is provided, default contact information for that TLD will be used. Before making request, ensure WHOIS information for desired TLD exists in your account. Some TLDs require additional_details to be provided and these will be validated before completing purchase. Use this endpoint to register new domains for users. Endpoint: POST /api/domains/v1/portfolio. Path params: none. Request body: required/accepted. Risk class: spend. This spend tool requires confirm=true and confirmation_phrase='I understand this may charge my Hostinger account'. 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-purchasenewdomainv1-example",
  "method": "tools/call",
  "params": {
    "name": "hostinger.domains_purchaseNewDomainV1",
    "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",
            "item_id"
          ],
          "properties": {
            "domain": {
              "type": "string",
              "description": "Domain name"
            },
            "coupons": {
              "type": "array",
              "items": {},
              "description": "Discount coupon codes"
            },
            "item_id": {
              "type": "string",
              "description": "Catalog price item ID"
            },
            "domain_contacts": {
              "type": "object",
              "properties": {
                "tech_id": {
                  "type": "integer",
                  "description": "Technical contact WHOIS record ID"
                },
                "admin_id": {
                  "type": "integer",
                  "description": "Administrative contact WHOIS record ID"
                },
                "owner_id": {
                  "type": "integer",
                  "description": "Owner contact WHOIS record ID"
                },
                "billing_id": {
                  "type": "integer",
                  "description": "Billing contact WHOIS record ID"
                }
              },
              "description": "Domain contact information"
            },
            "payment_method_id": {
              "type": "integer",
              "description": "Payment method ID, default will be used if not provided"
            },
            "additional_details": {
              "type": "object",
              "description": "Additional registration data, possible values depends on TLD"
            }
          }
        },
        {
          "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

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-purchasenewdomainv1-example",
  "method": "tools/call",
  "params": {
    "name": "hostinger.domains_purchaseNewDomainV1",
    "arguments": {
      "body": "",
      "params": "",
      "compact": "",
      "confirm": false,
      "dry_run": false,
      "max_items": "",
      "include_raw": false,
      "path_params": "",
      "confirmation_phrase": ""
    }
  }
}'

Node.js

const response = await fetch('https://portal.madpanda3d.com/api/mcp', {
  method: 'POST',
  headers: {
    Authorization: 'Bearer mad_live_***',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
  "jsonrpc": "2.0",
  "id": "hostinger-domains-purchasenewdomainv1-example",
  "method": "tools/call",
  "params": {
    "name": "hostinger.domains_purchaseNewDomainV1",
    "arguments": {
      "body": "",
      "params": "",
      "compact": "",
      "confirm": false,
      "dry_run": false,
      "max_items": "",
      "include_raw": false,
      "path_params": "",
      "confirmation_phrase": ""
    }
  }
}),
});
const data = await response.json();
console.log(data);

Python

import requests

url = 'https://portal.madpanda3d.com/api/mcp'
headers = {
    'Authorization': 'Bearer mad_live_***',
    'Content-Type': 'application/json',
}
payload = {
  "jsonrpc": "2.0",
  "id": "hostinger-domains-purchasenewdomainv1-example",
  "method": "tools/call",
  "params": {
    "name": "hostinger.domains_purchaseNewDomainV1",
    "arguments": {
      "body": "",
      "params": "",
      "compact": "",
      "confirm": false,
      "dry_run": false,
      "max_items": "",
      "include_raw": false,
      "path_params": "",
      "confirmation_phrase": ""
    }
  }
}
response = requests.post(url, headers=headers, json=payload, timeout=60)
print(response.json())

Example Responses

200 Success

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

502 Upstream Error

{
  "ok": false,
  "classification": "upstream_http_error",
  "message": "Upstream MCP returned a non-success status."
}