Show web VNC link

The link that opens the VNC console of one vServer in the browser - without a password.

WWriteIdempotentbetaNeeds service_vserver

Tool

manitu_vserver_vnc_web_geton https://mcp.manitu.de/mcp

POST

/v1/vserver/vnc/web/geton 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

Returns the link that opens the VNC console of a virtual server (vServer) in the browser (manitu's web VNC), by its vserver_id from manitu_vserver_list - the screen of the server, e.g. when SSH no longer answers. The link opens the console WITHOUT a password: give it to the customer only, as a link to click, and do not repeat it elsewhere. It holds until VNC is switched off and on again. url is null while VNC is off (vnc_enabled false) - switch it on first with manitu_vserver_vnc_enable. Ask the customer for an explicit yes first.

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

vnc_enabledbooleanrequired

The VNC console is switched on; if not, url is null.

urlstring | nullrequired

Opens the console in the browser, without a password - a secret, for the customer only. Null while VNC is off, or in the few minutes after switching it on.

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

vnc_enabledbooleanrequired

The VNC console is switched on; if not, url is null.

urlstring | nullrequired

Opens the console in the browser, without a password - a secret, for the customer only. Null while VNC is off, or in the few minutes after switching it on.

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

Result

{
  "structuredContent": {
    "vnc_enabled": true,
    "url": "https://www.example.com/"
  },
  "content": [
    {
      "type": "text",
      "text": "… the same answer as text …"
    }
  ],
  "isError": false
}

POST/v1/vserver/vnc/web/get

Request

curl -X POST 'https://api.manitu.de/v1/vserver/vnc/web/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/vnc/web/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/vnc/web/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/vnc/web/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": {
    "vnc_enabled": true,
    "url": "https://www.example.com/"
  }
}

Show web VNC link

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