List SSH users of a web hosting package

The SSH users of one web hosting package, with how to connect.

RReadIdempotentbetaNeeds service_webhosting

Tool

manitu_webhosting_web_sshuser_liston https://mcp.manitu.de/mcp

POST

/v1/webhosting/web/sshuser/liston https://api.manitu.de

Try it

Annotations as tools/list sends them

readOnlyHint truedestructiveHint falseidempotentHint trueopenWorldHint false

Description for the model

Lists the SSH users of a web hosting package of the manitu customer account this connection works in, by its site_id from manitu_webhosting_list: for each its username, description, status, whether it can log in now, when it expires, shell and disk space limit. Login is by public key only; the keys of one user are in manitu_webhosting_web_sshuser_get. connection says how to connect (SSH on port 22, the server's host key fingerprints). An SSH user reaches the whole package. count_max is how many SSH users the package allows.

Arguments

site_idinteger | stringrequired

The site_id from manitu_webhosting_list - never guess one.

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

Result structuredContent, checked against the schema

ssh_user_listarray of objectrequired

ssh_user_list[].usernamestringrequired

The user name to log in with (ssh<number>) - what the other SSH user tools take.

ssh_user_list[].descriptionstring | nullrequired

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

ssh_user_list[].statusstringrequired

active, or inactive (switched off by the customer, kept for later).

One of active inactive

ssh_user_list[].is_usable_nowbooleanrequired

It can log in right now: active and not expired.

ssh_user_list[].expires_atstring | nullrequired

When the SSH user expires. From this moment on it can no longer be used (the moment itself is excluded); null: without end.

Format date-time

ssh_user_list[].shellstring | nullrequired

The shell: bash, zsh, or git (git only - for pushing and pulling repositories).

One of bash zsh git null

ssh_user_list[].quota_mbinteger | nullrequired

Disk space in MB the files it owns may take; null: no limit of its own (the package's applies).

ssh_user_list[].created_atstring | nullrequired

When it was created.

Format date-time

ssh_user_list[].last_login_atstring | nullrequired

Its last login, null if never.

Format date-time

count_maxinteger | nullrequired

How many SSH users the package allows.

connectionobjectrequired

connection.hoststring | nullrequired

The host to connect to - the web server of the package.

connection.method_listarray of objectrequired

The ways to connect: SSH on port 22.

connection.method_list[].protocolstringrequired

One of ssh

connection.method_list[].portintegerrequired

connection.method_list[].is_encryptedbooleanrequired

connection.method_list[].is_recommendedbooleanrequired

connection.authstringrequired

public_key_only: log in with a key from the user's ssh_key_list - a password does not work.

One of public_key_only

connection.host_key_listarray of objectrequired

The server's host keys - on the first connection the SSH client shows one of these fingerprints; it must match.

connection.host_key_list[].algorithmstringrequired

connection.host_key_list[].fingerprint_sha256stringrequired

As the SSH client shows it, e.g. "SHA256:nThbg6kXUpJWGl7E1IGOCspRomTxdCARLviKw6E5SY8".

Authentication

One of X-API-Key, Authorization: Bearer … - never more than one in a request. More

Request body JSON; unknown fields are refused

site_idinteger | stringrequired

The site_id from manitu_webhosting_list - never guess one.

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

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

ssh_user_listarray of objectrequired

ssh_user_list[].usernamestringrequired

The user name to log in with (ssh<number>) - what the other SSH user tools take.

ssh_user_list[].descriptionstring | nullrequired

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

ssh_user_list[].statusstringrequired

active, or inactive (switched off by the customer, kept for later).

One of active inactive

ssh_user_list[].is_usable_nowbooleanrequired

It can log in right now: active and not expired.

ssh_user_list[].expires_atstring | nullrequired

When the SSH user expires. From this moment on it can no longer be used (the moment itself is excluded); null: without end.

Format date-time

ssh_user_list[].shellstring | nullrequired

The shell: bash, zsh, or git (git only - for pushing and pulling repositories).

One of bash zsh git null

ssh_user_list[].quota_mbinteger | nullrequired

Disk space in MB the files it owns may take; null: no limit of its own (the package's applies).

ssh_user_list[].created_atstring | nullrequired

When it was created.

Format date-time

ssh_user_list[].last_login_atstring | nullrequired

Its last login, null if never.

Format date-time

count_maxinteger | nullrequired

How many SSH users the package allows.

connectionobjectrequired

connection.hoststring | nullrequired

The host to connect to - the web server of the package.

connection.method_listarray of objectrequired

The ways to connect: SSH on port 22.

connection.method_list[].protocolstringrequired

One of ssh

connection.method_list[].portintegerrequired

connection.method_list[].is_encryptedbooleanrequired

connection.method_list[].is_recommendedbooleanrequired

connection.authstringrequired

public_key_only: log in with a key from the user's ssh_key_list - a password does not work.

One of public_key_only

connection.host_key_listarray of objectrequired

The server's host keys - on the first connection the SSH client shows one of these fingerprints; it must match.

connection.host_key_list[].algorithmstringrequired

connection.host_key_list[].fingerprint_sha256stringrequired

As the SSH client shows it, e.g. "SHA256:nThbg6kXUpJWGl7E1IGOCspRomTxdCARLviKw6E5SY8".

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_webhosting_web_sshuser_list",
    "arguments": {
      "site_id": 12345
    }
  }
}

Result

{
  "structuredContent": {
    "ssh_user_list": [
      {
        "username": "string",
        "description": "Example",
        "status": "active",
        "is_usable_now": true,
        "expires_at": "2026-10-23T12:00:00+02:00",
        "shell": "bash",
        "quota_mb": 1,
        "created_at": "2026-10-23T12:00:00+02:00",
        "last_login_at": "2026-10-23T12:00:00+02:00"
      }
    ],
    "count_max": 1,
    "connection": {
      "host": "string",
      "method_list": [
        {
          "protocol": "ssh",
          "port": 1,
          "is_encrypted": true,
          "is_recommended": true
        }
      ],
      "auth": "public_key_only",
      "host_key_list": [
        {
          "algorithm": "string",
          "fingerprint_sha256": "string"
        }
      ]
    }
  },
  "content": [
    {
      "type": "text",
      "text": "… the same answer as text …"
    }
  ],
  "isError": false
}

POST/v1/webhosting/web/sshuser/list

Request

curl -X POST 'https://api.manitu.de/v1/webhosting/web/sshuser/list' \
  -H 'X-API-Key: $API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
    "site_id": 12345
  }'

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

<?php

$curl = curl_init('https://api.manitu.de/v1/webhosting/web/sshuser/list');

curl_setopt_array($curl, [
    CURLOPT_CUSTOMREQUEST  => 'POST',
    CURLOPT_HTTPHEADER     => [
        'X-API-Key: ' . getenv('API_KEY'),
        'Content-Type: application/json',
    ],
    CURLOPT_POSTFIELDS     => '{"site_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/webhosting/web/sshuser/list",
    headers={"X-API-Key": os.environ["API_KEY"]},
    json={
        "site_id": 12345,
    },
)
answer = response.json()

Response 200

{
  "status": {
    "type": "success",
    "code": 200
  },
  "meta": {},
  "data": {
    "ssh_user_list": [
      {
        "username": "string",
        "description": "Example",
        "status": "active",
        "is_usable_now": true,
        "expires_at": "2026-10-23T12:00:00+02:00",
        "shell": "bash",
        "quota_mb": 1,
        "created_at": "2026-10-23T12:00:00+02:00",
        "last_login_at": "2026-10-23T12:00:00+02:00"
      }
    ],
    "count_max": 1,
    "connection": {
      "host": "string",
      "method_list": [
        {
          "protocol": "ssh",
          "port": 1,
          "is_encrypted": true,
          "is_recommended": true
        }
      ],
      "auth": "public_key_only",
      "host_key_list": [
        {
          "algorithm": "string",
          "fingerprint_sha256": "string"
        }
      ]
    }
  }
}

List SSH users of a web hosting package

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