Change settings of a web hosting package

Description, PHP version, IP logging, mail TLS and sender policy of a web hosting package.

WWriteIdempotentbetaNeeds service_webhosting

Tool

manitu_webhosting_seton https://mcp.manitu.de/mcp

POST

/v1/webhosting/seton https://api.manitu.de

Try it

Changes the account. Agents say what will happen and wait for an explicit yes before calling it.

Annotations as tools/list sends them

readOnlyHint falsedestructiveHint falseidempotentHint trueopenWorldHint false

Description for the model

Changes settings of a web hosting package of the manitu customer account this connection works in, by its site_id from manitu_webhosting_list - the same names manitu_webhosting_get shows: description; web.php_version (one of web.php.version_list, null: the package's default), web.log_ip_address_type; mail.tls_policy, mail.sender_policy. Only the fields given change. Read the package first with manitu_webhosting_get. A new PHP version can break the web pages (old software); tls_policy encrypt makes mail from servers without TLS be refused; a stricter sender_policy makes mail programs fail that send with addresses of other mailboxes - say so and ask for an explicit yes first. Refused per field for a part the package does not have (part_not_in_package), a PHP version not offered (php_version_not_available); with a conflict when the package cannot be changed now (not_configurable).

Provide at least one of: description, web, mail.

Arguments

site_idinteger | stringrequired

The site_id from manitu_webhosting_list - never guess one.

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

descriptionstring | null

The customer's description of the package. Left out: unchanged (set) or none (create); null or empty: none.

max length 1024

webobject

min fields 1

web.php_versionstring | null

The PHP version for the web pages, e.g. "php8.3" - one of web.php.version_list of manitu_webhosting_get. null: back to the package's default.

max length 32

web.log_ip_address_typestring

How the web server logs visitors' IP addresses: common - in full; anonymous-full - anonymised (the default, relevant for the GDPR).

One of common anonymous-full

mailobject

min fields 1

mail.tls_policystring

Encryption between mail servers for all domains of the package: may - used when the other side offers it (the default); encrypt - required, mail without it is refused.

One of may encrypt

mail.sender_policystring

Who may send over manitu's mail servers with a sender address of the package's domains: none - any authenticated login, any address; same_site - a login of this package (the default); same_mailbox - only the mailbox the address belongs to (its address or an alias). Applies to automatic replies as well.

One of none same_site same_mailbox

The tool list carries this simplified form: a rule at the root of a schema does not reach every client, so it is said in the description instead.

Result structuredContent, checked against the schema

site_idintegerrequired

The web hosting package - what its routes take. Globally unique; on the servers its home is /home/sites/site<site_id>.

service_typestringrequired

The kind of service - its own data is under the key of that name.

One of webhosting

descriptionstring | nullrequired

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

statusstring | nullrequired

The state of the contract, e.g. active, expiring (cancelled, runs out at paid_until).

is_configurablebooleanrequired

It can be changed right now - false e.g. while suspended or being moved.

planstring | nullrequired

The plan, e.g. "Webhosting M".

paid_untilstring | nullrequired

Paid up to this day.

Format date

created_atstring | nullrequired

Format date-time

webhostingobjectrequired

webhosting.package_namestring | nullrequired

The name of the package on contract and invoice - a domain name, but not a special one: all domains of a web hosting package work alike.

webhosting.site_namestring | nullrequired

site<site_id> - how the package is named on the servers (paths, SFTP).

webhosting.is_space_sharedbooleanrequired

Web and mail share one disk space - their quota counts the same use.

webhosting.migration_runningbooleanrequired

The package is being moved to another server right now - it cannot be changed meanwhile.

webhosting.webobject | nullrequired

The web part - null if the package has none.

webhosting.web.serverstring | nullrequired

The web server the package runs on (host name) - what SSH and SFTP/FTP connect to. Technical: mention it only for SSH/FTP or when asked.

webhosting.web.root_dirstring | nullrequired

The home of the web part on the server.

webhosting.web.htdocs_dirstring | nullrequired

Where the web pages are, relative to root_dir.

webhosting.web.ip_addressobjectrequired

webhosting.web.ip_address.ipv4object | nullrequired

webhosting.web.ip_address.ipv4.addressstringrequired

webhosting.web.ip_address.ipv4.is_dedicatedboolean | nullrequired

The package's own address, not shared with others.

webhosting.web.ip_address.ipv6object | nullrequired

webhosting.web.ip_address.ipv6.addressstringrequired

webhosting.web.ip_address.ipv6.is_dedicatedboolean | nullrequired

The package's own address, not shared with others.

webhosting.web.phpobject | nullrequired

null if the package has no PHP.

webhosting.web.php.versionstring | nullrequired

The PHP version in use, e.g. php8.2.

webhosting.web.php.version_sourcestring | nullrequired

customer: the customer chose it; package: the default the package was ordered (or last upgraded) with; manitu: manitu's general default.

One of customer package manitu null

webhosting.web.php.version_listarray of stringrequired

The versions the customer can choose.

webhosting.web.php.memory_limitstring | nullrequired

e.g. 512M

webhosting.web.php.max_execution_time_secondsinteger | nullrequired

webhosting.web.php.post_max_sizestring | nullrequired

webhosting.web.php.upload_max_filesizestring | nullrequired

webhosting.web.log_ip_address_typestring | nullrequired

How the web server logs visitors' IP addresses (/logs/web.log, /logs/web.err.log): common - in full; anonymous-full - anonymised (relevant for the GDPR). Other logs are never anonymised.

One of common anonymous-full null

webhosting.web.quotaobjectrequired

Disk space in MB and files, used and allowed - as last measured.

webhosting.web.quota.space_used_mbinteger | nullrequired

webhosting.web.quota.space_max_mbinteger | nullrequired

webhosting.web.quota.files_usedinteger | nullrequired

webhosting.web.quota.files_maxinteger | nullrequired

webhosting.web.quota.is_warningbooleanrequired

75 % or more of a limit used.

webhosting.web.quota.is_exceededbooleanrequired

A limit reached - nothing more can be stored.

webhosting.web.quota.measured_atstring | nullrequired

Format date-time

webhosting.web.limitobjectrequired

How many the package allows - how many are in use, the routes on them say.

webhosting.web.limit.database_count_maxinteger | nullrequired

webhosting.web.limit.ftp_user_count_maxinteger | nullrequired

webhosting.web.limit.ssh_user_count_maxinteger | nullrequired

webhosting.web.limit.cronjob_count_maxinteger | nullrequired

webhosting.web.limit.websitebuilder_count_maxinteger | nullrequired

webhosting.web.limit.subdomain_count_maxinteger | nullrequired

webhosting.web.feature_listarray of stringrequired

What the web part offers, e.g. php, cgi, ssi, application_installation, websitebuilder.

webhosting.mailobject | nullrequired

The mail part - null if the package has none.

webhosting.mail.mx_serverstring | nullrequired

The server that receives the package's e-mail - the MX target in DNS. NOT the server for mail programs (IMAP, POP3, SMTP): never give it to the customer as his mail server; mention it only when asked about MX.

webhosting.mail.tls_policystring | nullrequired

Encryption between mail servers for the package's domains: may - used when the other side offers it; encrypt - required, mail without it is refused. Applies to all domains of the package alike.

One of may encrypt null

webhosting.mail.sender_policystring | nullrequired

Who may send over manitu's mail servers with a sender address of the package's domains: none - any authenticated login, any address; same_site - a login of this package; same_mailbox - only the mailbox the address belongs to. Applies to all domains of the package alike.

One of none same_site same_mailbox null

webhosting.mail.quotaobjectrequired

Disk space in MB and files, used and allowed - as last measured.

webhosting.mail.quota.space_used_mbinteger | nullrequired

webhosting.mail.quota.space_max_mbinteger | nullrequired

webhosting.mail.quota.files_usedinteger | nullrequired

webhosting.mail.quota.files_maxinteger | nullrequired

webhosting.mail.quota.is_warningbooleanrequired

75 % or more of a limit used.

webhosting.mail.quota.is_exceededbooleanrequired

A limit reached - nothing more can be stored.

webhosting.mail.quota.measured_atstring | nullrequired

Format date-time

webhosting.mail.limitobjectrequired

How many the package allows - how many are in use, the routes on them say.

webhosting.mail.limit.mailbox_count_maxinteger | nullrequired

webhosting.mail.limit.mailing_list_count_maxinteger | nullrequired

webhosting.mail.feature_listarray of stringrequired

What the mail part offers, e.g. rspamd (spam filter), sieve (filter rules).

Authentication

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

Request body JSON; unknown fields are refused

Provide at least one of: description, web, mail.

site_idinteger | stringrequired

The site_id from manitu_webhosting_list - never guess one.

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

descriptionstring | null

The customer's description of the package. Left out: unchanged (set) or none (create); null or empty: none.

max length 1024

webobject

min fields 1

web.php_versionstring | null

The PHP version for the web pages, e.g. "php8.3" - one of web.php.version_list of manitu_webhosting_get. null: back to the package's default.

max length 32

web.log_ip_address_typestring

How the web server logs visitors' IP addresses: common - in full; anonymous-full - anonymised (the default, relevant for the GDPR).

One of common anonymous-full

mailobject

min fields 1

mail.tls_policystring

Encryption between mail servers for all domains of the package: may - used when the other side offers it (the default); encrypt - required, mail without it is refused.

One of may encrypt

mail.sender_policystring

One of none same_site same_mailbox

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

site_idintegerrequired

The web hosting package - what its routes take. Globally unique; on the servers its home is /home/sites/site<site_id>.

service_typestringrequired

The kind of service - its own data is under the key of that name.

One of webhosting

descriptionstring | nullrequired

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

statusstring | nullrequired

The state of the contract, e.g. active, expiring (cancelled, runs out at paid_until).

is_configurablebooleanrequired

It can be changed right now - false e.g. while suspended or being moved.

planstring | nullrequired

The plan, e.g. "Webhosting M".

paid_untilstring | nullrequired

Paid up to this day.

Format date

created_atstring | nullrequired

Format date-time

webhostingobjectrequired

webhosting.package_namestring | nullrequired

The name of the package on contract and invoice - a domain name, but not a special one: all domains of a web hosting package work alike.

webhosting.site_namestring | nullrequired

site<site_id> - how the package is named on the servers (paths, SFTP).

webhosting.is_space_sharedbooleanrequired

Web and mail share one disk space - their quota counts the same use.

webhosting.migration_runningbooleanrequired

The package is being moved to another server right now - it cannot be changed meanwhile.

webhosting.webobject | nullrequired

The web part - null if the package has none.

webhosting.web.serverstring | nullrequired

The web server the package runs on (host name) - what SSH and SFTP/FTP connect to. Technical: mention it only for SSH/FTP or when asked.

webhosting.web.root_dirstring | nullrequired

The home of the web part on the server.

webhosting.web.htdocs_dirstring | nullrequired

Where the web pages are, relative to root_dir.

webhosting.web.ip_addressobjectrequired

webhosting.web.ip_address.ipv4object | nullrequired

webhosting.web.ip_address.ipv4.addressstringrequired

webhosting.web.ip_address.ipv4.is_dedicatedboolean | nullrequired

The package's own address, not shared with others.

webhosting.web.ip_address.ipv6object | nullrequired

webhosting.web.ip_address.ipv6.addressstringrequired

webhosting.web.ip_address.ipv6.is_dedicatedboolean | nullrequired

The package's own address, not shared with others.

webhosting.web.phpobject | nullrequired

null if the package has no PHP.

webhosting.web.php.versionstring | nullrequired

The PHP version in use, e.g. php8.2.

webhosting.web.php.version_sourcestring | nullrequired

customer: the customer chose it; package: the default the package was ordered (or last upgraded) with; manitu: manitu's general default.

One of customer package manitu null

webhosting.web.php.version_listarray of stringrequired

The versions the customer can choose.

webhosting.web.php.memory_limitstring | nullrequired

e.g. 512M

webhosting.web.php.max_execution_time_secondsinteger | nullrequired

webhosting.web.php.post_max_sizestring | nullrequired

webhosting.web.php.upload_max_filesizestring | nullrequired

webhosting.web.log_ip_address_typestring | nullrequired

How the web server logs visitors' IP addresses (/logs/web.log, /logs/web.err.log): common - in full; anonymous-full - anonymised (relevant for the GDPR). Other logs are never anonymised.

One of common anonymous-full null

webhosting.web.quotaobjectrequired

Disk space in MB and files, used and allowed - as last measured.

webhosting.web.quota.space_used_mbinteger | nullrequired

webhosting.web.quota.space_max_mbinteger | nullrequired

webhosting.web.quota.files_usedinteger | nullrequired

webhosting.web.quota.files_maxinteger | nullrequired

webhosting.web.quota.is_warningbooleanrequired

75 % or more of a limit used.

webhosting.web.quota.is_exceededbooleanrequired

A limit reached - nothing more can be stored.

webhosting.web.quota.measured_atstring | nullrequired

Format date-time

webhosting.web.limitobjectrequired

How many the package allows - how many are in use, the routes on them say.

webhosting.web.limit.database_count_maxinteger | nullrequired

webhosting.web.limit.ftp_user_count_maxinteger | nullrequired

webhosting.web.limit.ssh_user_count_maxinteger | nullrequired

webhosting.web.limit.cronjob_count_maxinteger | nullrequired

webhosting.web.limit.websitebuilder_count_maxinteger | nullrequired

webhosting.web.limit.subdomain_count_maxinteger | nullrequired

webhosting.web.feature_listarray of stringrequired

What the web part offers, e.g. php, cgi, ssi, application_installation, websitebuilder.

webhosting.mailobject | nullrequired

The mail part - null if the package has none.

webhosting.mail.mx_serverstring | nullrequired

webhosting.mail.tls_policystring | nullrequired

Encryption between mail servers for the package's domains: may - used when the other side offers it; encrypt - required, mail without it is refused. Applies to all domains of the package alike.

One of may encrypt null

webhosting.mail.sender_policystring | nullrequired

One of none same_site same_mailbox null

webhosting.mail.quotaobjectrequired

Disk space in MB and files, used and allowed - as last measured.

webhosting.mail.quota.space_used_mbinteger | nullrequired

webhosting.mail.quota.space_max_mbinteger | nullrequired

webhosting.mail.quota.files_usedinteger | nullrequired

webhosting.mail.quota.files_maxinteger | nullrequired

webhosting.mail.quota.is_warningbooleanrequired

75 % or more of a limit used.

webhosting.mail.quota.is_exceededbooleanrequired

A limit reached - nothing more can be stored.

webhosting.mail.quota.measured_atstring | nullrequired

Format date-time

webhosting.mail.limitobjectrequired

How many the package allows - how many are in use, the routes on them say.

webhosting.mail.limit.mailbox_count_maxinteger | nullrequired

webhosting.mail.limit.mailing_list_count_maxinteger | nullrequired

webhosting.mail.feature_listarray of stringrequired

What the mail part offers, e.g. rspamd (spam filter), sieve (filter rules).

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_set",
    "arguments": {
      "site_id": 12345,
      "description": "Example"
    }
  }
}

Result

{
  "structuredContent": {
    "site_id": 12345,
    "service_type": "webhosting",
    "description": "Example",
    "status": "string",
    "is_configurable": true,
    "plan": "string",
    "paid_until": "2026-10-23",
    "created_at": "2026-10-23T12:00:00+02:00",
    "webhosting": {
      "package_name": "string",
      "site_name": "string",
      "is_space_shared": true,
      "migration_running": true,
      "web": {
        "server": "string",
        "root_dir": "/web",
        "htdocs_dir": "/web",
        "ip_address": {
          "ipv4": {
            "address": "string",
            "is_dedicated": true
          },
          "ipv6": {
            "address": "string",
            "is_dedicated": true
          }
        },
        "php": {
          "version": "string",
          "version_source": "customer",
          "version_list": [
            "string"
          ],
          "memory_limit": "string",
          "max_execution_time_seconds": 1,
          "post_max_size": "string",
          "upload_max_filesize": "string"
        },
        "log_ip_address_type": "common",
        "quota": {
          "space_used_mb": 1,
          "space_max_mb": 1,
          "files_used": 1,
          "files_max": 1,
          "is_warning": true,
          "is_exceeded": true,
          "measured_at": "2026-10-23T12:00:00+02:00"
        },
        "limit": {
          "database_count_max": 1,
          "ftp_user_count_max": 1,
          "ssh_user_count_max": 1,
          "cronjob_count_max": 1,
          "websitebuilder_count_max": 1,
          "subdomain_count_max": 1
        },
        "feature_list": [
          "string"
        ]
      },
      "mail": {
        "mx_server": "string",
        "tls_policy": "may",
        "sender_policy": "none",
        "quota": {
          "space_used_mb": 1,
          "space_max_mb": 1,
          "files_used": 1,
          "files_max": 1,
          "is_warning": true,
          "is_exceeded": true,
          "measured_at": "2026-10-23T12:00:00+02:00"
        },
        "limit": {
          "mailbox_count_max": 1,
          "mailing_list_count_max": 1
        },
        "feature_list": [
          "string"
        ]
      }
    }
  },
  "content": [
    {
      "type": "text",
      "text": "… the same answer as text …"
    }
  ],
  "isError": false
}

POST/v1/webhosting/set

Request

curl -X POST 'https://api.manitu.de/v1/webhosting/set' \
  -H 'X-API-Key: $API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
    "site_id": 12345,
    "description": "Example"
  }'

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

<?php

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

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

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

import os

import requests

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

Response 200

{
  "status": {
    "type": "success",
    "code": 200
  },
  "meta": {},
  "data": {
    "site_id": 12345,
    "service_type": "webhosting",
    "description": "Example",
    "status": "string",
    "is_configurable": true,
    "plan": "string",
    "paid_until": "2026-10-23",
    "created_at": "2026-10-23T12:00:00+02:00",
    "webhosting": {
      "package_name": "string",
      "site_name": "string",
      "is_space_shared": true,
      "migration_running": true,
      "web": {
        "server": "string",
        "root_dir": "/web",
        "htdocs_dir": "/web",
        "ip_address": {
          "ipv4": {
            "address": "string",
            "is_dedicated": true
          },
          "ipv6": {
            "address": "string",
            "is_dedicated": true
          }
        },
        "php": {
          "version": "string",
          "version_source": "customer",
          "version_list": [
            "string"
          ],
          "memory_limit": "string",
          "max_execution_time_seconds": 1,
          "post_max_size": "string",
          "upload_max_filesize": "string"
        },
        "log_ip_address_type": "common",
        "quota": {
          "space_used_mb": 1,
          "space_max_mb": 1,
          "files_used": 1,
          "files_max": 1,
          "is_warning": true,
          "is_exceeded": true,
          "measured_at": "2026-10-23T12:00:00+02:00"
        },
        "limit": {
          "database_count_max": 1,
          "ftp_user_count_max": 1,
          "ssh_user_count_max": 1,
          "cronjob_count_max": 1,
          "websitebuilder_count_max": 1,
          "subdomain_count_max": 1
        },
        "feature_list": [
          "string"
        ]
      },
      "mail": {
        "mx_server": "string",
        "tls_policy": "may",
        "sender_policy": "none",
        "quota": {
          "space_used_mb": 1,
          "space_max_mb": 1,
          "files_used": 1,
          "files_max": 1,
          "is_warning": true,
          "is_exceeded": true,
          "measured_at": "2026-10-23T12:00:00+02:00"
        },
        "limit": {
          "mailbox_count_max": 1,
          "mailing_list_count_max": 1
        },
        "feature_list": [
          "string"
        ]
      }
    }
  }
}

Change settings 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