Sommerhitze — alles schmilzt, sogar unsere Preise.−25%−25 % auf jeden Jahresplan, bis 31. Aug.Pläne ansehen
EQVPS
Loslegen

EQVPS-MCP-Tools: vollständige Referenz (16 Tools)

10. Juni 2026 · 4 Min. Lesezeit · EQVPS

Der EQVPS-MCP-Server stellt 16 Tools bereit, mit denen ein KI-Agent Pläne entdecken, ein Konto eröffnen, mit Krypto bezahlen und einen VPS vollständig betreiben kann. Endpunkt: https://mcp.eqvps.com/mcp (Streamable HTTP). Siehe die Verbindungsanleitung, um ihn in deinen Client einzubinden.

Auth-Modell: list_plans, register_account und login sind öffentlich. Jedes andere Tool erfordert ein Bearer-Token — beschaffe eines sofort von register_account und sende es als Authorization: Bearer <token>.

Discovery & Auth

ToolAuthParameterWas es tut
list_plansöffentlichAlle VPS-Pläne auflisten: Preise, Specs und die OS-Images, die jeder Plan booten kann. Rufe dies zuerst auf, um einen product-Slug und eine os_id zu wählen.
register_accountöffentlichfirst_name, last_name, emailEin Konto ohne Passwort und ohne menschlichen Schritt erstellen. Gibt ein Bearer-token zurück.
loginöffentlichemail, passwordMit E-Mail + Passwort anmelden; gibt ein Bearer-token zurück.
whoamiBearerDas authentifizierte Kontoprofil zurückgeben (id, Name, E-Mail). Verifiziert das Token.

Guthaben & Bestellung

ToolAuthParameterWas es tut
get_balanceBearerDas Prepaid-Guthaben und die Währung zurückgeben. order_vps gibt automatisch daraus aus.
topup_balanceBeareramount (USD, positiv)Eine Aufladerechnung erstellen; gibt eine PayRam-checkout_url zurück. Das Guthaben wird gutgeschrieben, sobald die On-Chain-USDC/USDT-Zahlung bestätigt ist. Eine unbezahlte Aufladung zur Zeit.
order_vpsBearerproduct (Plan-Slug), os_id (int), hostname?, ssh_key?Einen VPS bestellen. Übergib einen ssh_key (öffentlicher Schlüssel) für schlüsselbasierten root-Login. Zahlt aus dem Guthaben, wenn es reicht, sonst wird eine zu zahlende Rechnung zurückgegeben.
pay_invoiceBearerinvoice_id (int)Die Zahlung für eine eigene, unbezahlte Rechnung einleiten. Gibt eine PayRam-checkout_url zurück; der VPS wird automatisch bereitgestellt, sobald die Zahlung bestätigt ist.

Einen VPS betreiben

ToolAuthParameterWas es tut
list_vpsBearerDie VPS-Dienste des Kontos auflisten (id, Status, Plan). Nutze id unten als service_id.
get_vps_statusBearerservice_id (int)Volles Detail: Status, Specs, Live-VM-Zustand/Betriebszeit und SSH-Zugriff (Host, Port, einfügefertiger command). Beim ersten Aufruf für einen Server ohne Schlüssel gibt es das einmalige Root-password zurück. Nach order_vps abfragen, bis active.
power_vpsBearerservice_id, action = start | stop | rebootDen VPS strom-steuern.
set_hostnameBearerservice_id, hostnameDen VPS-Hostnamen setzen (gültiges DNS-Label; beim nächsten Neustart/Rebuild angewendet).
get_vps_metricsBearerservice_id, timeframe? = hour | day | week | monthZeitreihen-Metriken für CPU, Arbeitsspeicher, Netzwerk und Disk (Standard hour).

Destruktiv — erfordern confirm

Diese löschen Daten oder Zugriff. confirm muss genau dem Hostnamen (aus get_vps_status) oder dem wörtlichen DELETE entsprechen. Zuerst mit dem Menschen bestätigen.

ToolAuthParameterWas es tut
reset_passwordBearerservice_id, confirmDas Root-Passwort rotieren. Das ALTE Passwort funktioniert sofort nicht mehr. Das neue Passwort wird einmal über get_vps_status gelesen (auch per E-Mail).
reinstall_vpsBearerservice_id, os_id (int), confirmMit dem angegebenen OS-Image löschen und neu installieren — alle Daten gehen verloren. Die Bereitstellung ist asynchron; frage get_vps_status ab.
cancel_serviceBearerservice_id, type? = end_of_period | immediate, confirm?Standard end_of_period: bleibt aktiv bis zum Ende der bezahlten Periode, dann keine Verlängerung — kein Datenverlust. immediate zerstört die VM und alle Daten jetzt (erfordert confirm = Hostname); die ungenutzte bezahlte Zeit wird deinem Guthaben erstattet (refund_amount).

Beispiel: einen VPS bestellen und booten

list_plans()                                  // Produkt "nano" wählen, eine os_id notieren
register_account({ first_name, last_name, email })   // → Bearer-Token
topup_balance({ amount: 10 })                 // die zurückgegebene checkout_url in USDC/USDT zahlen
order_vps({ product: "nano", os_id: <os_id aus list_plans>, ssh_key: "ssh-ed25519 AAAA..." })
get_vps_status({ service_id: <deine-service-id> }) // abfragen → active, SSH-Host/Port/command lesen
power_vps({ service_id: <deine-service-id>, action: "reboot" })

Hinweise für Agenten

Neu beim Setup? Beginne mit der Verbindungsanleitung oder lies die Docs für die zugrunde liegende REST-API.

FAQ

Wie rufe ich diese Tools auf?

Verbinde einen MCP-Client mit https://mcp.eqvps.com/mcp (Streamable HTTP) und rufe das Tool per Namen mit den aufgeführten Parametern auf. Siehe die Verbindungsanleitung für Claude Desktop, Cursor und Cline.

Welche Tools brauchen ein Bearer-Token?

Nur die Katalog-/Auth-Tools sind öffentlich: list_plans, register_account, login. Alles andere erfordert Authorization: Bearer <token> — hol dir ein Token von register_account.

Welche Tools sind destruktiv?

reinstall_vps und ein sofortiges cancel_service löschen die VM und alle Daten; reset_password macht das aktuelle Root-Passwort ungültig. Alle drei erfordern einen confirm-Wert, der genau dem Hostnamen (oder 'DELETE') entspricht, und sollten zuerst mit dem Menschen bestätigt werden.

Gibt es Ratenbegrenzungen?

Ja — sensible Aktionen (reinstall, reset_password, cancel, power, order, top-up) sind serverseitig ratenbegrenzt. Normale Agentennutzung bleibt weit innerhalb der Grenzen.

← Zurück zum BlogPläne & Preise ansehen →

Kommentare

Noch keine Kommentare. Sei der Erste.

Kommentar hinterlassen

Kommentare werden vor der Anzeige moderiert.