List running workflows of a virtual server

The workflows still running on one vServer, oldest first.

RReadIdempotentbetaNeeds service_vserver

Tool

manitu_vserver_workflow_liston https://mcp.manitu.de/mcp

POST

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

Try it

Annotations as tools/list sends them

readOnlyHint truedestructiveHint falseidempotentHint trueopenWorldHint false

Description for the model

Lists the workflows still running on a virtual server (vServer) - a restart, a reverse DNS change, a snapshot - by its vserver_id from manitu_vserver_list, oldest first; empty when nothing runs. The same list manitu_vserver_get answers as pending_workflow_list: use this one to check again whether a workflow is done.

Arguments

vserver_idinteger | stringrequired

The vserver_id from manitu_vserver_list - never guess one.

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

page_sizeinteger

How many entries per page, default 100.

min 1max 500

page_tokenstring

next_page_token of the previous page - with the same filters.

Result structuredContent, checked against the schema

workflow_listarray of objectrequired

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

workflow_list[].workflow_idstringrequired

The id of this run of the workflow.

workflow_list[].created_atstring | nullrequired

When it was asked for.

Format date-time

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

total_countintegerrequired

How many entries match, on all pages together.

next_page_tokenstring | nullrequired

Pass as page_token for the next page; null on the last.

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

page_sizeinteger

How many entries per page, default 100.

min 1max 500

page_tokenstring

next_page_token of the previous page - with the same filters.

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

workflow_listarray of objectrequired

workflow_list[].workflowstringrequired

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

workflow_list[].workflow_idstringrequired

The id of this run of the workflow.

workflow_list[].created_atstring | nullrequired

When it was asked for.

Format date-time

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

total_countintegerrequired

How many entries match, on all pages together.

next_page_tokenstring | nullrequired

Pass as page_token for the next page; null on the last.

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

Result

{
  "structuredContent": {
    "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"
      }
    ],
    "total_count": 1,
    "next_page_token": "eyJwYWdlIjoyfQ"
  },
  "content": [
    {
      "type": "text",
      "text": "… the same answer as text …"
    }
  ],
  "isError": false
}

POST/v1/vserver/workflow/list

Request

curl -X POST 'https://api.manitu.de/v1/vserver/workflow/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/workflow/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/workflow/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/workflow/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": {
    "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"
      }
    ],
    "total_count": 1,
    "next_page_token": "eyJwYWdlIjoyfQ"
  }
}

List running workflows 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