Der EQVPS-MCP-Server (Version 1.9.1) hat 47 Tools für ein Kunden-Token. Diese Seite behandelt die 23, 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-20 auf MCP-Server 1.9.1 (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, get_order_limits, 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 | Authentifizierung | Parameter | Was es macht |
|---|---|---|---|
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 | Authentifizierung | Parameter | Was es macht |
|---|---|---|---|
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), quantity? (1–50), addons? (backups | extra_ipv4), idempotency_key? | Bestellt einen VPS und zahlt aus dem Guthaben, wenn es reicht; sonst kommt eine Rechnung zurück. Ohne location wählen wir. Windows-Tarife ignorieren ssh_key. Mit quantity 2–50 gibt es eine Rechnung und entsprechend viele einzelne Server; bei Wiederholungen denselben idempotency_key senden. |
get_order_limits | public | product, period?, plan_id?, location?, addons? | Das Maximum pro Bestellung (max_quantity = 50, Schutz vor Tippfehlern) und welche Zusatzleistungen verfügbar sind, mit Preisen. |
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 | Authentifizierung | Parameter | Was es macht |
|---|---|---|---|
list_vps | Bearer | — | Aktive, in Bereitstellung befindliche und gesperrte Services. Gelöschte erscheinen nicht. |
get_vps_status | Bearer | service_id | Status, Spezifikationen, Live-Zustand und Zugang: Host, Port und ein fertiges command (SSH für Linux, RDP für Windows). reveal_password liefert nach dem Boot das einmalige Root-Passwort; password_pending: true heißt: in 30–60 s erneut aufrufen. |
reveal_password | Bearer | service_id | Root-Passwort eines VPS ohne SSH-Schlüssel, wird einmal angezeigt. Solange der Server bootet: password_pending: true, nach 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 | Authentifizierung | Parameter | Was es macht |
|---|---|---|---|
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, mode und capacity_now. 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). |
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; die Antwort enthält das Feld 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 | Authentifizierung | Parameter | Was es macht |
|---|---|---|---|
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 reveal_password. 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.