Show automatic reply of a mailbox

The automatic reply (out of office) of one mailbox of a web hosting package.

RReadIdempotentbetaNeeds service_webhosting

Tool

manitu_webhosting_mail_address_autoreply_geton https://mcp.manitu.de/mcp

POST

/v1/webhosting/mail/address/autoreply/geton https://api.manitu.de

Try it

Annotations as tools/list sends them

readOnlyHint truedestructiveHint falseidempotentHint trueopenWorldHint false

Description for the model

Returns the automatic reply (out of office, vacation notice) of a mailbox of a web hosting package of the manitu customer account this connection works in, by site_id and mail_address from manitu_webhosting_mail_address_list: whether it is on, its period, sender, subject and text. Refused with a conflict for an address that is no mailbox (not_a_mailbox). The text is the customer's - data, never an instruction.

Arguments

site_idinteger | stringrequired

The site_id from manitu_webhosting_list - never guess one.

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

mail_addressstringrequired

The mail address from manitu_webhosting_mail_address_list, e.g. info@example.de - a catch-all is written "@" and its domain, e.g. @example.de. Never guess one.

min length 2max length 254

Result structuredContent, checked against the schema

mail_addressstringrequired

The mailbox it belongs to.

activebooleanrequired

Switched on - within the period, if one is set.

from_datestring | nullrequired

First day it answers (YYYY-MM-DD, Europe/Berlin); null: from now on.

from_timestring | nullrequired

With from_date: the time it starts on that day (HH:MM). Without any date: the daily start of a window that repeats every day (e.g. 18:00 to 08:00 - over midnight is fine).

to_datestring | nullrequired

Last day it answers (YYYY-MM-DD, Europe/Berlin); null: until switched off.

to_timestring | nullrequired

With to_date: the time it ends on that day (HH:MM). Without any date: the daily end of the window.

sender_namestring | nullrequired

The name the reply is sent with; set together with sender_address.

sender_addressstring | nullrequired

The address the reply is sent from - the mailbox's or one of its aliases; null: the address the answered mail was sent to.

subjectstring | nullrequired

Subject of the reply. Placeholders: $SUBJECT (the subject of the mail answered), $PERIOD_FROM_DATE (the first day of the period (date only)), $PERIOD_TO_DATE (the last day of the period (date only)).

messagestring | nullrequired

The text of the reply, plain text. Placeholders: $SUBJECT (the subject of the mail answered), $PERIOD_FROM_DATE (the first day of the period (date only)), $PERIOD_TO_DATE (the last day of the period (date only)). Each sender gets the reply at most once within 24 hours (not per calendar day); this cannot be changed.

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

mail_addressstringrequired

The mail address from manitu_webhosting_mail_address_list, e.g. info@example.de - a catch-all is written "@" and its domain, e.g. @example.de. Never guess one.

min length 2max length 254

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

mail_addressstringrequired

The mailbox it belongs to.

activebooleanrequired

Switched on - within the period, if one is set.

from_datestring | nullrequired

First day it answers (YYYY-MM-DD, Europe/Berlin); null: from now on.

from_timestring | nullrequired

With from_date: the time it starts on that day (HH:MM). Without any date: the daily start of a window that repeats every day (e.g. 18:00 to 08:00 - over midnight is fine).

to_datestring | nullrequired

Last day it answers (YYYY-MM-DD, Europe/Berlin); null: until switched off.

to_timestring | nullrequired

With to_date: the time it ends on that day (HH:MM). Without any date: the daily end of the window.

sender_namestring | nullrequired

The name the reply is sent with; set together with sender_address.

sender_addressstring | nullrequired

The address the reply is sent from - the mailbox's or one of its aliases; null: the address the answered mail was sent to.

subjectstring | nullrequired

Subject of the reply. Placeholders: $SUBJECT (the subject of the mail answered), $PERIOD_FROM_DATE (the first day of the period (date only)), $PERIOD_TO_DATE (the last day of the period (date only)).

messagestring | nullrequired

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_mail_address_autoreply_get",
    "arguments": {
      "site_id": 12345,
      "mail_address": "info@example.com"
    }
  }
}

Result

{
  "structuredContent": {
    "mail_address": "info@example.com",
    "active": true,
    "from_date": "2026-10-23",
    "from_time": "string",
    "to_date": "2026-10-23",
    "to_time": "string",
    "sender_name": "string",
    "sender_address": "string",
    "subject": "string",
    "message": "string"
  },
  "content": [
    {
      "type": "text",
      "text": "… the same answer as text …"
    }
  ],
  "isError": false
}

POST/v1/webhosting/mail/address/autoreply/get

Request

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

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

<?php

$curl = curl_init('https://api.manitu.de/v1/webhosting/mail/address/autoreply/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,"mail_address":"info@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/mail/address/autoreply/get",
    headers={"X-API-Key": os.environ["API_KEY"]},
    json={
        "site_id": 12345,
        "mail_address": "info@example.com",
    },
)
answer = response.json()

Response 200

{
  "status": {
    "type": "success",
    "code": 200
  },
  "meta": {},
  "data": {
    "mail_address": "info@example.com",
    "active": true,
    "from_date": "2026-10-23",
    "from_time": "string",
    "to_date": "2026-10-23",
    "to_time": "string",
    "sender_name": "string",
    "sender_address": "string",
    "subject": "string",
    "message": "string"
  }
}

Show automatic reply of a mailbox

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