List snapshots of a virtual server

The snapshots of one vServer, newest first, and how many it may have.

RReadIdempotentbetaNeeds service_vserver

Tool

manitu_vserver_snapshot_liston https://mcp.manitu.de/mcp

POST

/v1/vserver/snapshot/liston https://api.manitu.de

Try it

Annotations as tools/list sends them

readOnlyHint truedestructiveHint falseidempotentHint trueopenWorldHint false

Description for the model

Lists the snapshots of a virtual server (vServer), by its vserver_id from manitu_vserver_list, newest first: when each was taken, when it expires and is deleted automatically, the note the customer gave it, whether the server was running at the time, and which one is the active base (the server runs on from it). snapshot_count_max is how many the server may have - at that count, one has to be deleted before another can be taken. Not a backup for a reinstall: manitu_vserver_reinstall deletes all snapshots of the server along with its data.

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

snapshot_listarray of objectrequired

The snapshots, newest first.

snapshot_list[].snapshot_idstringrequired

The id of the snapshot - what manitu_vserver_snapshot_revert and _delete take.

snapshot_list[].descriptionstring | nullrequired

The note the customer gave it, if any.

snapshot_list[].created_atstring | nullrequired

When it was taken.

Format date-time

snapshot_list[].expires_atstring | nullrequired

When it is deleted automatically.

Format date-time

snapshot_list[].is_active_basebooleanrequired

The active base: the server runs on from this snapshot - everything changed since is its live state.

snapshot_list[].power_state_at_creationstring | nullrequired

Whether the server was running when it was taken.

One of running stopped null

snapshot_count_maxintegerrequired

How many snapshots the server may have.

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

snapshot_listarray of objectrequired

The snapshots, newest first.

snapshot_list[].snapshot_idstringrequired

The id of the snapshot - what manitu_vserver_snapshot_revert and _delete take.

snapshot_list[].descriptionstring | nullrequired

The note the customer gave it, if any.

snapshot_list[].created_atstring | nullrequired

When it was taken.

Format date-time

snapshot_list[].expires_atstring | nullrequired

When it is deleted automatically.

Format date-time

snapshot_list[].is_active_basebooleanrequired

The active base: the server runs on from this snapshot - everything changed since is its live state.

snapshot_list[].power_state_at_creationstring | nullrequired

Whether the server was running when it was taken.

One of running stopped null

snapshot_count_maxintegerrequired

How many snapshots the server may have.

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

Result

{
  "structuredContent": {
    "snapshot_list": [
      {
        "snapshot_id": "string",
        "description": "Example",
        "created_at": "2026-10-23T12:00:00+02:00",
        "expires_at": "2026-10-23T12:00:00+02:00",
        "is_active_base": true,
        "power_state_at_creation": "running"
      }
    ],
    "snapshot_count_max": 1
  },
  "content": [
    {
      "type": "text",
      "text": "… the same answer as text …"
    }
  ],
  "isError": false
}

POST/v1/vserver/snapshot/list

Request

curl -X POST 'https://api.manitu.de/v1/vserver/snapshot/list' \
  -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/snapshot/list', {
  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/snapshot/list');

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/snapshot/list",
    headers={"X-API-Key": os.environ["API_KEY"]},
    json={
        "vserver_id": 12345,
    },
)
answer = response.json()

Response 200

{
  "status": {
    "type": "success",
    "code": 200
  },
  "meta": {},
  "data": {
    "snapshot_list": [
      {
        "snapshot_id": "string",
        "description": "Example",
        "created_at": "2026-10-23T12:00:00+02:00",
        "expires_at": "2026-10-23T12:00:00+02:00",
        "is_active_base": true,
        "power_state_at_creation": "running"
      }
    ],
    "snapshot_count_max": 1
  }
}

List snapshots 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