Show how to connect to a web hosting package

Host, protocols and ports for FTP, SSH and mail programs of one web hosting package.

RReadIdempotentbetaNeeds service_webhosting

Tool

manitu_webhosting_connection_geton https://mcp.manitu.de/mcp

POST

/v1/webhosting/connection/geton https://api.manitu.de

Try it

Annotations as tools/list sends them

readOnlyHint truedestructiveHint falseidempotentHint trueopenWorldHint false

Description for the model

Returns how to connect to a web hosting package of the manitu customer account this connection works in, by its site_id from manitu_webhosting_list - for "how do I connect?", "what do I enter in my mail program / FTP program?": ftp (host, protocols with ports - SFTP on port 23, not 22), ssh (host, port, key login only, host key fingerprints) and mail (the server for mail programs - IMAP, POP3, SMTP - with ports and security; NOT the MX server). The user name is each user's own: FTP and SSH users from their list tools, for mail the full address of the mailbox. Passwords are never shown.

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

ftpobject | nullrequired

FTP - null if the package has no web part.

ftp.hoststring | nullrequired

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

ftp.method_listarray of objectrequired

The ways to connect, the one to prefer first. SFTP is on port 23, NOT 22; implicit FTPS is not offered; plain FTP (unencrypted) only if nothing else works.

ftp.method_list[].protocolstringrequired

sftp (SSH file transfer), ftps_explicit (FTP with explicit TLS, AUTH TLS), ftp (unencrypted).

One of sftp ftps_explicit ftp

ftp.method_list[].portintegerrequired

ftp.method_list[].is_encryptedbooleanrequired

ftp.method_list[].is_recommendedbooleanrequired

ftp.web_ftp_urlstringrequired

FTP in the browser, with the same user name and password.

sshobject | nullrequired

SSH - null if the package has no web part.

ssh.hoststring | nullrequired

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

ssh.method_listarray of objectrequired

The ways to connect: SSH on port 22.

ssh.method_list[].protocolstringrequired

One of ssh

ssh.method_list[].portintegerrequired

ssh.method_list[].is_encryptedbooleanrequired

ssh.method_list[].is_recommendedbooleanrequired

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

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

ssh.host_key_list[].algorithmstringrequired

ssh.host_key_list[].fingerprint_sha256stringrequired

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

mailobject | nullrequired

Mail programs - null if the package has no mail part.

mail.hoststringrequired

The server a mail program connects to - for receiving (IMAP, POP3) and sending (SMTP) alike. NOT the MX server of the package.

mail.method_listarray of objectrequired

The ways to connect, per protocol the one to prefer first - encrypted only, there is no unencrypted way. Receiving: IMAP (mail stays on the server, several devices) or POP3 (mail is fetched); sending: SMTP with login (the same user name and password) - port 587 with STARTTLS where 465 is blocked.

mail.method_list[].protocolstringrequired

One of imap pop3 smtp

mail.method_list[].portintegerrequired

mail.method_list[].securitystringrequired

ssl_tls: encrypted from the start (often "SSL/TLS"); starttls: switched to encryption after connecting ("STARTTLS").

One of ssl_tls starttls

mail.method_list[].is_recommendedbooleanrequired

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

ftpobject | nullrequired

FTP - null if the package has no web part.

ftp.hoststring | nullrequired

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

ftp.method_listarray of objectrequired

The ways to connect, the one to prefer first. SFTP is on port 23, NOT 22; implicit FTPS is not offered; plain FTP (unencrypted) only if nothing else works.

ftp.method_list[].protocolstringrequired

sftp (SSH file transfer), ftps_explicit (FTP with explicit TLS, AUTH TLS), ftp (unencrypted).

One of sftp ftps_explicit ftp

ftp.method_list[].portintegerrequired

ftp.method_list[].is_encryptedbooleanrequired

ftp.method_list[].is_recommendedbooleanrequired

ftp.web_ftp_urlstringrequired

FTP in the browser, with the same user name and password.

sshobject | nullrequired

SSH - null if the package has no web part.

ssh.hoststring | nullrequired

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

ssh.method_listarray of objectrequired

The ways to connect: SSH on port 22.

ssh.method_list[].protocolstringrequired

One of ssh

ssh.method_list[].portintegerrequired

ssh.method_list[].is_encryptedbooleanrequired

ssh.method_list[].is_recommendedbooleanrequired

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

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

ssh.host_key_list[].algorithmstringrequired

ssh.host_key_list[].fingerprint_sha256stringrequired

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

mailobject | nullrequired

Mail programs - null if the package has no mail part.

mail.hoststringrequired

The server a mail program connects to - for receiving (IMAP, POP3) and sending (SMTP) alike. NOT the MX server of the package.

mail.method_listarray of objectrequired

mail.method_list[].protocolstringrequired

One of imap pop3 smtp

mail.method_list[].portintegerrequired

mail.method_list[].securitystringrequired

ssl_tls: encrypted from the start (often "SSL/TLS"); starttls: switched to encryption after connecting ("STARTTLS").

One of ssl_tls starttls

mail.method_list[].is_recommendedbooleanrequired

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

Result

{
  "structuredContent": {
    "ftp": {
      "host": "string",
      "method_list": [
        {
          "protocol": "sftp",
          "port": 1,
          "is_encrypted": true,
          "is_recommended": true
        }
      ],
      "web_ftp_url": "https://www.example.com/"
    },
    "ssh": {
      "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"
        }
      ]
    },
    "mail": {
      "host": "string",
      "method_list": [
        {
          "protocol": "imap",
          "port": 1,
          "security": "ssl_tls",
          "is_recommended": true
        }
      ]
    }
  },
  "content": [
    {
      "type": "text",
      "text": "… the same answer as text …"
    }
  ],
  "isError": false
}

POST/v1/webhosting/connection/get

Request

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

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

Response 200

{
  "status": {
    "type": "success",
    "code": 200
  },
  "meta": {},
  "data": {
    "ftp": {
      "host": "string",
      "method_list": [
        {
          "protocol": "sftp",
          "port": 1,
          "is_encrypted": true,
          "is_recommended": true
        }
      ],
      "web_ftp_url": "https://www.example.com/"
    },
    "ssh": {
      "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"
        }
      ]
    },
    "mail": {
      "host": "string",
      "method_list": [
        {
          "protocol": "imap",
          "port": 1,
          "security": "ssl_tls",
          "is_recommended": true
        }
      ]
    }
  }
}

Show how to connect to 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