Brauche ich einen MCP-Client?

Nein. Das ist einfaches REST über HTTPS — nutzbar von curl, jeder Sprache oder einem Agenten, der HTTP spricht. Wenn du MCP nutzt, werden dieselben Aktionen als Tools bereitgestellt (siehe den Verbindungs-Leitfaden).

Wie funktioniert die Auth?

Rufe /auth/register auf, um ein Bearer-Token zu bekommen (kein Passwort). Sende es als Header Authorization: Bearer bei jedem authentifizierten Aufruf. /products ist öffentlich.

Lade ein Prepaid-Guthaben über /balance/topup auf (gibt eine Krypto-Checkout-URL zurück; zahle in USDC/USDT). order belastet dann das Guthaben. Falls nicht aufgeladen, gibt order eine Rechnung zurück, die du über /invoices/{id}/pay zahlst.

Was enthält die Bestell-Antwort?

Entweder paid_from_balance mit einer Service-ID (Bereitstellung gestartet) oder eine zu zahlende Rechnung. Poll GET /services/{id}, bis der Status active ist, dann lies den SSH-Host, Port und ein Einmal-root-Passwort.

Einen VPS in 4 API-Aufrufen bestellen (REST-Schnellstart für Agenten)

Du brauchst keinen MCP-Client, um EQVPS zu steuern — die REST-API tut alles, was ein Agent braucht. Basis-URL: https://api.eqvps.com/api/v1/eqvps. Hier ist der ganze Ablauf in vier Aufrufen.

0. (einmal) Ein Prepaid-Guthaben aufladen

Damit das Bestellen ein einzelner Aufruf ist, lade zuerst ein Guthaben auf. Zahle den zurückgegebenen Checkout in USDC/USDT:

curl -s -X POST https://api.eqvps.com/api/v1/eqvps/balance/topup \
  -H "Authorization: Bearer <YOUR_BEARER>" -H "Content-Type: application/json" \
  -d '{"amount": 25}'
# → { "checkout_url": "https://payram.eqvps.com/..." }  ← zahle es in USDC/USDT

1. Registrieren → Bearer-Token

curl -s -X POST https://api.eqvps.com/api/v1/eqvps/auth/register \
  -H "Content-Type: application/json" \
  -d '{"first_name":"Ada","last_name":"Agent","email":"ada@example.com"}'
# → { "token": "<YOUR_BEARER>", "token_type": "Bearer", "user": {...} }

Kein Passwort, kein menschlicher Schritt. Speichere das Token; sende es unten als Authorization: Bearer <YOUR_BEARER>.

2. Pläne auflisten → Produkt + os_id wählen (öffentlich)

curl -s https://api.eqvps.com/api/v1/eqvps/products
# → { "data": [ { "slug": "<product-slug>", "price": {...},
#       "specs": {...}, "available_os": [ { "id": <os_id>, "name": "Ubuntu 24.04" }, ... ] }, ... ] }

Wähle einen Plan-slug und eine os_id aus der available_os dieses Plans.

3. Einen VPS bestellen

curl -s -X POST https://api.eqvps.com/api/v1/eqvps/orders \
  -H "Authorization: Bearer <YOUR_BEARER>" -H "Content-Type: application/json" \
  -d '{"product":"<product-slug>","os_id":<os_id from list_plans>,"ssh_key":"ssh-ed25519 AAAA..."}'
# → aus Guthaben bezahlt: { "paid_from_balance": true, "service_id": <id> }
#   oder nicht aufgeladen: { "invoice": { "id": <id> } }  → zahlen: POST /invoices/{id}/pay → checkout_url

Übergib einen ssh_key (öffentlichen Schlüssel) für schlüsselbasiertes root-Login. Mit einem aufgeladenen Guthaben wird die Bestellung sofort bezahlt und die Bereitstellung beginnt.

4. Zugang lesen

curl -s https://api.eqvps.com/api/v1/eqvps/services/<service-id> \
  -H "Authorization: Bearer <YOUR_BEARER>"
# → { "status": "active", "access": { "host": "...", "port": 22, "command": "ssh root@..." },
#     "password": "<einmal für schlüssellose Server angezeigt>" , ... }

Poll, bis der status active ist. Der access-Block hat den SSH-Host, Port und einen fertig einzufügenden command; für eine schlüssellose Bestellung wird das Einmal-root-password beim ersten Lesen zurückgegeben.

Hinweise für Agenten

Sende Authorization: Bearer <YOUR_BEARER> bei jedem Aufruf außer /products.
Zahle in USDC/USDT (Base, Ethereum, Polygon) — keine Karte nötig. Bevorzuge das Prepaid-Guthaben, damit Schritt 3 ein Aufruf ist.
Sensible Aktionen (order, reset-password, reinstall, cancel) sind rate-limitiert; normale Nutzung liegt gut innerhalb der Limits.
Bevorzugst du Tools statt rohem HTTP? Dieselben Aktionen sind MCP-Tools — siehe den Verbindungs-Leitfaden und die Tool-Referenz. Vollständige Docs: /docs.