Change description and hostname of a virtual server

The description and hostname manitu keeps for a vServer – nothing on the server itself changes.

WWriteIdempotentbetaNeeds service_vserver

Tool

manitu_vserver_seton https://mcp.manitu.de/mcp

POST

/v1/vserver/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 the description and/or hostname manitu keeps for a virtual server (vServer), by its vserver_id from manitu_vserver_list - what the customer panel and manitu_vserver_list show. It does not change anything on the server itself (not its operating system's hostname, not its reverse DNS - that is manitu_vserver_ptr_set). Answers the vServer as changed. A hostname that is none is refused.

Provide at least one of: description, hostname.

Arguments

vserver_idinteger | stringrequired

The vserver_id from manitu_vserver_list - never guess one.

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

descriptionstring | null

The customer's description of it, e.g. "shop, production". Left out: unchanged (set) or none (create); null or empty: none.

max length 1024

hostnamestring | null

Its hostname, e.g. "web1.example.com". Left out: unchanged (set) or none (create); null or empty: none.

max length 253

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

vserver_idintegerrequired

The id of the vServer - what manitu_vserver_get and every route on it take (the same number as service_id).

service_idintegerrequired

The id of the service instance - the same number as the id its own routes take (e.g. vserver_id).

service_typestringrequired

The kind of service, e.g. vserver - its own data is under the key of that name.

One of vserver other

descriptionstring | nullrequired

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

statusstringrequired

Its state as a service, e.g. active.

One of active provisioning suspended destroying deleted

is_configurablebooleanrequired

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

planstring | nullrequired

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

vserverobjectrequired

What is the vServer's own.

vserver.hostnamestring | nullrequired

Its hostname as manitu keeps it, if set.

vserver.power_statestring | nullrequired

e.g. running or stopped - as manitu last saw it: updated with every workflow on the server and once a day, so a shutdown from inside the server may not show yet; null if unknown.

One of stopped running suspended installing null

vserver.ipv4_addressstring | nullrequired

Its IPv4 address.

vserver.ipv6_addressstring | nullrequired

Its IPv6 address.

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, hostname.

vserver_idinteger | stringrequired

The vserver_id from manitu_vserver_list - never guess one.

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

descriptionstring | null

The customer's description of it, e.g. "shop, production". Left out: unchanged (set) or none (create); null or empty: none.

max length 1024

hostnamestring | null

Its hostname, e.g. "web1.example.com". Left out: unchanged (set) or none (create); null or empty: none.

max length 253

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

vserver_idintegerrequired

The id of the vServer - what manitu_vserver_get and every route on it take (the same number as service_id).

service_idintegerrequired

The id of the service instance - the same number as the id its own routes take (e.g. vserver_id).

service_typestringrequired

The kind of service, e.g. vserver - its own data is under the key of that name.

One of vserver other

descriptionstring | nullrequired

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

statusstringrequired

Its state as a service, e.g. active.

One of active provisioning suspended destroying deleted

is_configurablebooleanrequired

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

planstring | nullrequired

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

vserverobjectrequired

What is the vServer's own.

vserver.hostnamestring | nullrequired

Its hostname as manitu keeps it, if set.

vserver.power_statestring | nullrequired

e.g. running or stopped - as manitu last saw it: updated with every workflow on the server and once a day, so a shutdown from inside the server may not show yet; null if unknown.

One of stopped running suspended installing null

vserver.ipv4_addressstring | nullrequired

Its IPv4 address.

vserver.ipv6_addressstring | nullrequired

Its IPv6 address.

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

Result

{
  "structuredContent": {
    "vserver_id": 12345,
    "service_id": 12345,
    "service_type": "vserver",
    "description": "Example",
    "status": "active",
    "is_configurable": true,
    "plan": "string",
    "vserver": {
      "hostname": "server.example.com",
      "power_state": "stopped",
      "ipv4_address": "192.0.2.10",
      "ipv6_address": "2001:db8::10"
    }
  },
  "content": [
    {
      "type": "text",
      "text": "… the same answer as text …"
    }
  ],
  "isError": false
}

POST/v1/vserver/set

Request

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

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

<?php

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

curl_setopt_array($curl, [
    CURLOPT_CUSTOMREQUEST  => 'POST',
    CURLOPT_HTTPHEADER     => [
        'X-API-Key: ' . getenv('API_KEY'),
        'Content-Type: application/json',
    ],
    CURLOPT_POSTFIELDS     => '{"vserver_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/vserver/set",
    headers={"X-API-Key": os.environ["API_KEY"]},
    json={
        "vserver_id": 12345,
        "description": "Example",
    },
)
answer = response.json()

Response 200

{
  "status": {
    "type": "success",
    "code": 200
  },
  "meta": {},
  "data": {
    "vserver_id": 12345,
    "service_id": 12345,
    "service_type": "vserver",
    "description": "Example",
    "status": "active",
    "is_configurable": true,
    "plan": "string",
    "vserver": {
      "hostname": "server.example.com",
      "power_state": "stopped",
      "ipv4_address": "192.0.2.10",
      "ipv6_address": "2001:db8::10"
    }
  }
}

Change description and hostname of a virtual server

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