Add recipients to a mailing list

Put a few addresses on one mailing list of a web hosting package - the others stay.

WWriteIdempotentbetaNeeds service_webhosting

Tool

manitu_webhosting_mail_mailinglist_recipient_addon https://mcp.manitu.de/mcp

POST

/v1/webhosting/mail/mailinglist/recipient/addon 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

Adds recipients to a mailing list of a web hosting package of the manitu customer account this connection works in, by site_id and mail_address from manitu_webhosting_mail_mailinglist_list. The recipients there stay; an address already on it is answered as unchanged. At most 1000 recipients per list (else a conflict, limit_reached). Refused per address that is none (mail_address_invalid) or the list itself (target_is_address_itself). The people added get every mail sent to the list - only with their consent: name every address to the customer and ask for an explicit yes first.

Arguments

site_idinteger | stringrequired

The site_id from manitu_webhosting_list - never guess one.

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

mail_addressstringrequired

The address of the mailing list from manitu_webhosting_mail_mailinglist_list, e.g. club@example.de. Never guess one.

min length 2max length 254

recipient_listarray of stringrequired

The addresses to put on the list.

min items 1max items 1000

Result structuredContent, checked against the schema

mail_addressstringrequired

The list.

recipient_countintegerrequired

How many recipients it has now.

changed_listarray of stringrequired

The addresses put on the list.

unchanged_listarray of stringrequired

The addresses given that were so already - nothing to do for them.

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 address of the mailing list from manitu_webhosting_mail_mailinglist_list, e.g. club@example.de. Never guess one.

min length 2max length 254

recipient_listarray of stringrequired

The addresses to put on the list.

min items 1max items 1000

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

mail_addressstringrequired

The list.

recipient_countintegerrequired

How many recipients it has now.

changed_listarray of stringrequired

The addresses put on the list.

unchanged_listarray of stringrequired

The addresses given that were so already - nothing to do for them.

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_mailinglist_recipient_add",
    "arguments": {
      "site_id": 12345,
      "mail_address": "info@example.com",
      "recipient_list": [
        "string"
      ]
    }
  }
}

Result

{
  "structuredContent": {
    "mail_address": "info@example.com",
    "recipient_count": 1,
    "changed_list": [
      "string"
    ],
    "unchanged_list": [
      "string"
    ]
  },
  "content": [
    {
      "type": "text",
      "text": "… the same answer as text …"
    }
  ],
  "isError": false
}

POST/v1/webhosting/mail/mailinglist/recipient/add

Request

curl -X POST 'https://api.manitu.de/v1/webhosting/mail/mailinglist/recipient/add' \
  -H 'X-API-Key: $API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
    "site_id": 12345,
    "mail_address": "info@example.com",
    "recipient_list": [
      "string"
    ]
  }'

const response = await fetch('https://api.manitu.de/v1/webhosting/mail/mailinglist/recipient/add', {
  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",
    "recipient_list": [
      "string"
    ]
  }),
});
const answer = await response.json();

<?php

$curl = curl_init('https://api.manitu.de/v1/webhosting/mail/mailinglist/recipient/add');

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","recipient_list":["string"]}',
    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/mailinglist/recipient/add",
    headers={"X-API-Key": os.environ["API_KEY"]},
    json={
        "site_id": 12345,
        "mail_address": "info@example.com",
        "recipient_list": [
            "string",
        ],
    },
)
answer = response.json()

Response 200

{
  "status": {
    "type": "success",
    "code": 200
  },
  "meta": {},
  "data": {
    "mail_address": "info@example.com",
    "recipient_count": 1,
    "changed_list": [
      "string"
    ],
    "unchanged_list": [
      "string"
    ]
  }
}

Add recipients to a mailing list

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