Der EQVPS-MCP-Server (Version 1.6.0) hat 45 Tools für ein Kunden-Token. Diese Seite behandelt die 21, die einen VPS mieten und betreiben: jeden Parameter, seinen Typ und Standardwert, und am Ende eine Aufrufkette zum Kopieren. Endpoint: https://mcp.eqvps.com/mcp (Streamable HTTP). Neu dabei? Fang mit der Verbindungsanleitung an.
Zuletzt geprüft am 2026-10-04 auf MCP-Server 1.6.0 (tools/list).
Welche Seite brauchst du? Parameter für VPS-Aufrufe stehen auf dieser Seite. Alle Tools in einer Liste, inklusive Delegierung, Support, Sandboxes und der 30 Reseller-Tools, findest du in der vollständigen Liste. Was ein geleaktes Token anrichten kann und wie du einen Agenten begrenzt, steht in MCP guardrails.
Auth. list_plans, register_account und login sind öffentlich. Alles andere braucht Authorization: Bearer <token>. Innerhalb einer MCP-Sitzung wird das Token nach register_account oder login gespeichert.
service_id ist der Service-Code aus order_vps oder list_vps, zum Beispiel 68J67T5. Eine numerische id funktioniert auch.
Konto und Token
| Tool | Auth | Parameters | What it does |
|---|---|---|---|
list_plans | public | — | Tarife mit Preisen, Spezifikationen und den OS-Images, die jeder bootet. plans[] enthält die monatliche und jährliche plan_id. Zuerst aufrufen. |
register_account | public | first_name, last_name, email, token_ttl_days? (1–1825, Standard 365) | Legt ein Konto ohne Passwort an und gibt ein wiederverwendbares Bearer-token mit token_expires_at zurück. Nur einmal aufrufen: ein zweiter Aufruf legt ein zweites, leeres Konto an. |
login | public | email, password, token_ttl_days? | Gibt ein neues Token zurück. Funktioniert erst nach set_password. |
refresh_token | Bearer | expires_in_days? (1–1825) | Stellt ein neues Token aus und widerruft das aktuelle sofort. Ein abgelaufenes Token lässt sich nicht erneuern. |
set_password | Bearer | password (8+ Zeichen, Buchstaben und Ziffern) | Schaltet login per E-Mail und Passwort als Rückfall frei, falls das Token verloren geht. Geht einmal; ein zweiter Aufruf liefert 409. |
whoami | Bearer | — | Konto-id, Name und E-Mail. Damit prüfst du das Token. |
Guthaben und Bestellung
| Tool | Auth | Parameters | What it does |
|---|---|---|---|
get_balance | Bearer | — | Prepaid-Guthaben und Währung. order_vps zahlt daraus. |
topup_balance | Bearer | amount (USD) | Legt eine Krypto-Aufladung an und gibt eine checkout_url zurück. Das Guthaben wird gutgeschrieben, sobald die Zahlung on-chain bestätigt ist. Jeweils nur eine offene Aufladung. |
order_vps | Bearer | product, os_id, hostname?, ssh_key?, period? (month | year), plan_id?, location? (de | fi) | Bestellt einen VPS und zahlt aus dem Guthaben, wenn es reicht; sonst kommt eine Rechnung zurück. Ohne location wählen wir. Ein Standort ohne freie Kapazität liefert 409 location_unavailable mit einer available-Liste, und nichts wird abgebucht. Windows-Tarife ignorieren ssh_key. |
pay_invoice | Bearer | invoice_id | Gibt eine checkout_url für eine offene Rechnung zurück. Der VPS wird nach der Zahlung angelegt. |
VPS betreiben
| Tool | Auth | Parameters | What it does |
|---|---|---|---|
list_vps | Bearer | — | Aktive, in Bereitstellung befindliche und gesperrte Services. Gelöschte erscheinen nicht. |
get_vps_status | Bearer | service_id, reveal? | Status, Spezifikationen, Live-Zustand und Zugang: Host, Port und ein fertiges command (SSH für Linux, RDP für Windows). reveal: true liefert nach dem Boot das einmalige Root-Passwort; password_pending: true heißt: in 30–60 s erneut aufrufen. |
power_vps | Bearer | service_id, action (start | stop | reboot) | Stromsteuerung. |
set_hostname | Bearer | service_id, hostname | Wird im laufenden Server über den Guest Agent gesetzt. Unter Windows greift es nach einem Neustart (reboot_required: true). Ist der Server aus, kommt 409 agent_unavailable. |
get_vps_metrics | Bearer | service_id, timeframe? (hour | day | week | month, Standard hour) | CPU, Arbeitsspeicher, Netzwerk und Datenträger im Zeitverlauf. |
Tarifwechsel und Kündigung
| Tool | Auth | Parameters | What it does |
|---|---|---|---|
get_upgrade_options | Bearer | service_id | Tarife, auf die dieser VPS mit erhaltenen Daten wechseln kann: ein größerer Tarif, NAT zu dedizierter IPv4 oder dediziert zu NAT. Jede Option zeigt prorated_topup und mode. Ein Datenträger kann nicht schrumpfen. |
change_plan | Bearer | service_id, target_plan (product_id), confirm: true | Wechselt den Tarif an Ort und Stelle mit einem Neustart von etwa einer Minute. Die anteilige Differenz wird vom Guthaben abgebucht (402, wenn es nicht reicht); ein Wechsel zu NAT erstattet die Differenz. |
cancel_service | Bearer | service_id, reason (3–500 Zeichen, Pflicht), type? (end_of_period | immediate), confirm? | Standard end_of_period: der Server läuft bis zum Ende des bezahlten Zeitraums und wird nicht verlängert. immediate zerstört den Server sofort, braucht confirm mit dem exakten Hostnamen und erstattet die ungenutzte Zeit aufs Guthaben (refund_amount). |
undo_cancel | Bearer | service_id | Hebt eine geplante Kündigung end_of_period auf. Eine sofortige lässt sich nicht rückgängig machen. |
Destruktiv: diese brauchen confirm
confirm ist der exakte Hostname aus get_vps_status oder DELETE. Frag vor dem Aufruf den Menschen.
| Tool | Auth | Parameters | What it does |
|---|---|---|---|
reset_password | Bearer | service_id, confirm | Ein neues Root-Passwort ist in 10–30 s auf dem laufenden Server aktiv, das alte funktioniert nicht mehr. Lies das neue einmal mit get_vps_status (reveal: true). Nur für ein verlorenes Passwort, nicht für einen Server, der noch bootet. |
reinstall_vps | Bearer | service_id, os_id, confirm | Löscht den Datenträger und installiert os_id. Alle Daten gehen verloren. Läuft im Hintergrund; frag get_vps_status ab. |
Beispiel: von null zum laufenden Server
list_plans() // pick a product slug and an os_id
register_account({ first_name: "Ada", last_name: "Agent", email: "you@yourdomain.com" }) // returns a token
topup_balance({ amount: 10 }) // pay the checkout_url in crypto
order_vps({ product: "nano", os_id: <os_id>, ssh_key: "ssh-ed25519 AAAA..." }) // returns a service_id
get_vps_status({ service_id: "<service_id>" }) // poll until active, then read access.command
power_vps({ service_id: "<service_id>", action: "reboot" })
cancel_service({ service_id: "<service_id>", reason: "project finished" }) // end_of_period; undo_cancel keeps it
Hinweise für Agenten
- Sende
Authorization: Bearer <token>bei jedem Aufruf außer den drei öffentlichen. Bei reinem HTTP speichere das Token in einer Datei: eine Shell-Variable überlebt getrennte Befehle nicht. - Lies die Zugangsdaten aus
get_vps_status, statt den Port zu raten. NAT-Tarife nutzen einen persönlichen Port; Tarife mit dedizierter IPv4 nutzen 22 für Linux und 3389 für Windows. - Ein neuer Server braucht etwa eine Minute zum Booten. Frag weiter
get_vps_statusab; rufreset_passwordnicht auf, nur weil SSH nicht sofort geantwortet hat. topup_balanceundpay_invoicegeben einen Zahlungslink zurück, den ein Mensch oder eine Wallet bezahlen muss. Monero ist eine separate manuelle Aufladung im Dashboard: siehe mit Monero bezahlen.
Dieselben Aktionen ohne MCP findest du in der REST-API-Doku.
Kommentare
Noch keine Kommentare. Sei der Erste.