Show virtual server details

One vServer by id: status, power state, plan, hardware, network, rescue system, VNC, running workflows.

RReadIdempotentbetaNeeds service_vserver

Tool

manitu_vserver_geton https://mcp.manitu.de/mcp

POST

/v1/vserver/geton https://api.manitu.de

Try it

Annotations as tools/list sends them

readOnlyHint truedestructiveHint falseidempotentHint trueopenWorldHint false

Description for the model

Returns one virtual server (vServer) of the manitu customer account this connection works in, by its vserver_id from manitu_vserver_list (never guess one): description, hostname, status, power state (as manitu last saw it), plan and hardware, IPv4/IPv6 with gateway and reverse DNS, whether the rescue system and the VNC console are on, and the workflows still running on it (e.g. a reboot just asked for). For the operating systems it can be reinstalled with use manitu_vserver_product_get. Not found if the account has no such vServer; refused if this access may not see it.

Arguments

vserver_idinteger | stringrequired

The vserver_id from manitu_vserver_list - never guess one.

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

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".

plan_codestring | nullrequired

The plan as a code, e.g. "vserver_server_m".

contract_idinteger | nullrequired

The contract it runs under.

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.

vserver.hardwareobjectrequired

What the plan comes with.

vserver.hardware.cpu_coresinteger | nullrequired

vserver.hardware.ram_gbinteger | nullrequired

vserver.hardware.disk_gbinteger | nullrequired

vserver.hardware.disk_typestring | nullrequired

e.g. "SSD".

vserver.networkobjectrequired

vserver.network.ipv4object | nullrequired

vserver.network.ipv4.addressstring | nullrequired

vserver.network.ipv4.prefixinteger | nullrequired

vserver.network.ipv4.netmaskstring | nullrequired

IPv4 only.

vserver.network.ipv4.gatewaystring | nullrequired

vserver.network.ipv4.ptr_recordstring | nullrequired

The reverse DNS name of the address.

vserver.network.ipv6object | nullrequired

vserver.network.ipv6.addressstring | nullrequired

vserver.network.ipv6.prefixinteger | nullrequired

vserver.network.ipv6.netmaskstring | nullrequired

IPv4 only.

vserver.network.ipv6.gatewaystring | nullrequired

vserver.network.ipv6.ptr_recordstring | nullrequired

The reverse DNS name of the address.

vserver.rescue_system_enabledbooleanrequired

It boots into manitu's rescue system instead of its own disk.

vserver.vnc_enabledbooleanrequired

The VNC console is switched on.

pending_workflow_listarray of objectrequired

Workflows on it that are still running, oldest first - e.g. a reboot just asked for.

pending_workflow_list[].workflowstringrequired

What is being done, e.g. a reboot.

One of create destroy power_start power_stop power_reboot reinstall ptr_set vnc_enable vnc_disable rescuesystem_enable rescuesystem_disable snapshot_create snapshot_delete snapshot_delete_all snapshot_revert telemetry_await iso_eject

pending_workflow_list[].workflow_idstringrequired

The id of this run of the workflow.

pending_workflow_list[].created_atstring | nullrequired

When it was asked for.

Format date-time

pending_workflow_list[].started_atstring | nullrequired

When it started; null while it waits for the next run - usually a minute or two, at times longer. Nothing to tell the customer unless asked.

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

vserver_idinteger | stringrequired

The vserver_id from manitu_vserver_list - never guess one.

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

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".

plan_codestring | nullrequired

The plan as a code, e.g. "vserver_server_m".

contract_idinteger | nullrequired

The contract it runs under.

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.

vserver.hardwareobjectrequired

What the plan comes with.

vserver.hardware.cpu_coresinteger | nullrequired

vserver.hardware.ram_gbinteger | nullrequired

vserver.hardware.disk_gbinteger | nullrequired

vserver.hardware.disk_typestring | nullrequired

e.g. "SSD".

vserver.networkobjectrequired

vserver.network.ipv4object | nullrequired

vserver.network.ipv4.addressstring | nullrequired

vserver.network.ipv4.prefixinteger | nullrequired

vserver.network.ipv4.netmaskstring | nullrequired

IPv4 only.

vserver.network.ipv4.gatewaystring | nullrequired

vserver.network.ipv4.ptr_recordstring | nullrequired

The reverse DNS name of the address.

vserver.network.ipv6object | nullrequired

vserver.network.ipv6.addressstring | nullrequired

vserver.network.ipv6.prefixinteger | nullrequired

vserver.network.ipv6.netmaskstring | nullrequired

IPv4 only.

vserver.network.ipv6.gatewaystring | nullrequired

vserver.network.ipv6.ptr_recordstring | nullrequired

The reverse DNS name of the address.

vserver.rescue_system_enabledbooleanrequired

It boots into manitu's rescue system instead of its own disk.

vserver.vnc_enabledbooleanrequired

The VNC console is switched on.

pending_workflow_listarray of objectrequired

Workflows on it that are still running, oldest first - e.g. a reboot just asked for.

pending_workflow_list[].workflowstringrequired

What is being done, e.g. a reboot.

pending_workflow_list[].workflow_idstringrequired

The id of this run of the workflow.

pending_workflow_list[].created_atstring | nullrequired

When it was asked for.

Format date-time

pending_workflow_list[].started_atstring | nullrequired

When it started; null while it waits for the next run - usually a minute or two, at times longer. Nothing to tell the customer unless asked.

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

Result

{
  "structuredContent": {
    "vserver_id": 12345,
    "service_id": 12345,
    "service_type": "vserver",
    "description": "Example",
    "status": "active",
    "is_configurable": true,
    "plan": "string",
    "plan_code": "string",
    "contract_id": 12345,
    "vserver": {
      "hostname": "server.example.com",
      "power_state": "stopped",
      "ipv4_address": "192.0.2.10",
      "ipv6_address": "2001:db8::10",
      "hardware": {
        "cpu_cores": 1,
        "ram_gb": 1,
        "disk_gb": 1,
        "disk_type": "string"
      },
      "network": {
        "ipv4": {
          "address": "string",
          "prefix": 1,
          "netmask": "string",
          "gateway": "string",
          "ptr_record": "string"
        },
        "ipv6": {
          "address": "string",
          "prefix": 1,
          "netmask": "string",
          "gateway": "string",
          "ptr_record": "string"
        }
      },
      "rescue_system_enabled": true,
      "vnc_enabled": true
    },
    "pending_workflow_list": [
      {
        "workflow": "create",
        "workflow_id": "string",
        "created_at": "2026-10-23T12:00:00+02:00",
        "started_at": "2026-10-23T12:00:00+02:00"
      }
    ]
  },
  "content": [
    {
      "type": "text",
      "text": "… the same answer as text …"
    }
  ],
  "isError": false
}

POST/v1/vserver/get

Request

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

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

<?php

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

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

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

import os

import requests

response = requests.request(
    "POST",
    "https://api.manitu.de/v1/vserver/get",
    headers={"X-API-Key": os.environ["API_KEY"]},
    json={
        "vserver_id": 12345,
    },
)
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",
    "plan_code": "string",
    "contract_id": 12345,
    "vserver": {
      "hostname": "server.example.com",
      "power_state": "stopped",
      "ipv4_address": "192.0.2.10",
      "ipv6_address": "2001:db8::10",
      "hardware": {
        "cpu_cores": 1,
        "ram_gb": 1,
        "disk_gb": 1,
        "disk_type": "string"
      },
      "network": {
        "ipv4": {
          "address": "string",
          "prefix": 1,
          "netmask": "string",
          "gateway": "string",
          "ptr_record": "string"
        },
        "ipv6": {
          "address": "string",
          "prefix": 1,
          "netmask": "string",
          "gateway": "string",
          "ptr_record": "string"
        }
      },
      "rescue_system_enabled": true,
      "vnc_enabled": true
    },
    "pending_workflow_list": [
      {
        "workflow": "create",
        "workflow_id": "string",
        "created_at": "2026-10-23T12:00:00+02:00",
        "started_at": "2026-10-23T12:00:00+02:00"
      }
    ]
  }
}

Show virtual server details

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