Show subdomain of a web hosting package

One subdomain of a web hosting package: what it may be used for and what uses it.

RReadIdempotentbetaNeeds service_webhosting

Tool

manitu_webhosting_subdomain_geton https://mcp.manitu.de/mcp

POST

/v1/webhosting/subdomain/geton https://api.manitu.de

Try it

Annotations as tools/list sends them

readOnlyHint truedestructiveHint falseidempotentHint trueopenWorldHint false

Description for the model

Returns one subdomain of a web hosting package of the manitu customer account this connection works in, by site_id and fqdn from manitu_webhosting_subdomain_list: whether it may be used for web and mail, what uses it now (a website, mail addresses), its description.

Arguments

site_idinteger | stringrequired

The site_id from manitu_webhosting_list - never guess one.

pattern ^[1-9][0-9]*$min 1

fqdnstringrequired

The subdomain from manitu_webhosting_subdomain_list, e.g. cloud.example.de. Never guess one.

min length 3max length 253

Result structuredContent, checked against the schema

fqdnstringrequired

The full name, e.g. cloud.example.de - what the other tools take. Unicode for an internationalized domain.

fqdn_asciistringrequired

The same name as DNS has it (xn--... for an internationalized domain).

hoststringrequired

The part before the domain, e.g. cloud - may have several levels (alt.intern).

domainstringrequired

The domain of the package it is under.

for_webbooleanrequired

May be used for websites (vHosts), redirects etc.

for_mailbooleanrequired

May be used for mail addresses and mailing lists.

in_useobjectrequired

What uses it now - a used service cannot be switched off, a used subdomain not deleted.

in_use.webbooleanrequired

A website (vHost) has this name.

in_use.mailbooleanrequired

A mail address or mailing list is at this name.

descriptionstring | nullrequired

What the customer wrote about it (his description), null if nothing - not its name or user name.

created_atstring | nullrequired

Format date-time

Authentication

One of X-API-Key, Authorization: Bearer … - never more than one in a request. More

Request body JSON; unknown fields are refused

site_idinteger | stringrequired

The site_id from manitu_webhosting_list - never guess one.

pattern ^[1-9][0-9]*$min 1

fqdnstringrequired

The subdomain from manitu_webhosting_subdomain_list, e.g. cloud.example.de. Never guess one.

min length 3max length 253

Response in `data`; the rest of the body as on every call

fqdnstringrequired

The full name, e.g. cloud.example.de - what the other tools take. Unicode for an internationalized domain.

fqdn_asciistringrequired

The same name as DNS has it (xn--... for an internationalized domain).

hoststringrequired

The part before the domain, e.g. cloud - may have several levels (alt.intern).

domainstringrequired

The domain of the package it is under.

for_webbooleanrequired

May be used for websites (vHosts), redirects etc.

for_mailbooleanrequired

May be used for mail addresses and mailing lists.

in_useobjectrequired

What uses it now - a used service cannot be switched off, a used subdomain not deleted.

in_use.webbooleanrequired

A website (vHost) has this name.

in_use.mailbooleanrequired

A mail address or mailing list is at this name.

descriptionstring | nullrequired

What the customer wrote about it (his description), null if nothing - not its name or user name.

created_atstring | nullrequired

Format date-time

Statuses

200Success.400The request does not match the declared input schema.401No credential was presented, or it was not recognised.403The credential is not permitted to use this operation.500The server failed. Nothing about the request was wrong. Whether a change took effect is not known - check before trying it again.503The channel this operation forwards through is unavailable.

MCPtools/call

Request

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "manitu_webhosting_subdomain_get",
    "arguments": {
      "site_id": 12345,
      "fqdn": "example.com"
    }
  }
}

Result

{
  "structuredContent": {
    "fqdn": "example.com",
    "fqdn_ascii": "string",
    "host": "string",
    "domain": "example.com",
    "for_web": true,
    "for_mail": true,
    "in_use": {
      "web": true,
      "mail": true
    },
    "description": "Example",
    "created_at": "2026-10-23T12:00:00+02:00"
  },
  "content": [
    {
      "type": "text",
      "text": "… the same answer as text …"
    }
  ],
  "isError": false
}

POST/v1/webhosting/subdomain/get

Request

curl -X POST 'https://api.manitu.de/v1/webhosting/subdomain/get' \
  -H 'X-API-Key: $API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
    "site_id": 12345,
    "fqdn": "example.com"
  }'

const response = await fetch('https://api.manitu.de/v1/webhosting/subdomain/get', {
  method: 'POST',
  headers: {
    'X-API-Key': process.env.API_KEY,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "site_id": 12345,
    "fqdn": "example.com"
  }),
});
const answer = await response.json();

<?php

$curl = curl_init('https://api.manitu.de/v1/webhosting/subdomain/get');

curl_setopt_array($curl, [
    CURLOPT_CUSTOMREQUEST  => 'POST',
    CURLOPT_HTTPHEADER     => [
        'X-API-Key: ' . getenv('API_KEY'),
        'Content-Type: application/json',
    ],
    CURLOPT_POSTFIELDS     => '{"site_id":12345,"fqdn":"example.com"}',
    CURLOPT_RETURNTRANSFER => true,
]);

$answer = json_decode(curl_exec($curl), true);

import os

import requests

response = requests.request(
    "POST",
    "https://api.manitu.de/v1/webhosting/subdomain/get",
    headers={"X-API-Key": os.environ["API_KEY"]},
    json={
        "site_id": 12345,
        "fqdn": "example.com",
    },
)
answer = response.json()

Response 200

{
  "status": {
    "type": "success",
    "code": 200
  },
  "meta": {},
  "data": {
    "fqdn": "example.com",
    "fqdn_ascii": "string",
    "host": "string",
    "domain": "example.com",
    "for_web": true,
    "for_mail": true,
    "in_use": {
      "web": true,
      "mail": true
    },
    "description": "Example",
    "created_at": "2026-10-23T12:00:00+02:00"
  }
}

Show subdomain of a web hosting package

Annotations as tools/list sends them

Description for the model

Arguments

Result structuredContent, checked against the schema

Authentication

Request body JSON; unknown fields are refused

Response in data; the rest of the body as on every call

Statuses

Response in `data`; the rest of the body as on every call