API- & MCP-Dokumentation

So bezahlst du

Du musst nicht bereits Krypto besitzen — eine Karte funktioniert auch. EQVPS nimmt Krypto direkt (nur eine E-Mail, kein KYC), und direkt beim Checkout kannst du die Krypto per Karte, Apple Pay oder Google Pay kaufen. So funktioniert jede Methode.

Konto & Abrechnung

Alles nach der ersten Bestellung — Gutscheincodes, Verlängern, Upgraden.

MCP für KI-Agenten

EQVPS stellt einen Model-Context-Protocol-(MCP)-Server bereit, damit KI-Agenten Pläne entdecken, einen VPS bestellen, aus einem Prepaid-Guthaben zahlen und Server verwalten können — autonom. Der Endpunkt spricht Streamable HTTP (der Remote-MCP-Standard 2026).

claude mcp add --transport http eqvps https://mcp.eqvps.com/mcp

Registriere ein EQVPS-Konto, zeige mir Pläne, erstelle eine Krypto-Aufladerechnung über 20 $, und sobald ich die Zahlung bestätige, bestelle 2 Ubuntu-24.04-VPS und gib mir ihren SSH-Zugriff.

Verbinde deinen Agenten

Füge dies zur Konfiguration deines MCP-Clients hinzu (Claude Desktop oder jeder Remote-HTTP-MCP-Client):

{
  "mcpServers": {
    "eqvps": {
      "type": "streamable-http",
      "url": "https://mcp.eqvps.com/mcp",
      "headers": { "Authorization": "Bearer <YOUR_TOKEN>" }
    }
  }
}

Erhalte ein Token, indem du register_account oder login über den MCP-Server selbst aufrufst. Das Tool list_plans funktioniert ohne Token (Discovery). Du kannst auch ein Token in deinem Konto unter Einstellungen → API-Tokens für Agenten generieren.

Authentifizierung

EQVPS verwendet Bearer-Tokens — es gibt jedoch zwei GETRENNTE Auth-Pfade, mische sie nicht. KI-Agenten: rufe register_account (oder login) über diese API/MCP auf — der Agent liefert seine eigenen Zugangsdaten und erhält sofort ein Token, OHNE E-Mail und OHNE OTP-Code. Sende es als Authorization: Bearer <token>. Menschen auf eqvps.com melden sich mit einem passwortlosen E-Mail-OTP-Code an — dieser Browser-Flow ist nur für Menschen und ein Agent kann ihn nicht nutzen (er kann keine E-Mails lesen). Ein Agent muss register_account verwenden, niemals den E-Mail-OTP-Flow. list_plans benötigt kein Token.

MCP-Tools

15 Tools, nach Zweck gruppiert. Jedes bildet auf einen REST-Endpunkt ab.

Beispielablauf

Eine typische Agentensitzung: entdecken, registrieren, aufladen, bestellen, verwalten.

// 1. Discover plans (no auth)
list_plans()
// 2. Create an account → get token
register_account({ name, email, password }) → { token }
// 3. (human or agent) fund the balance with crypto
topup_balance({ amount: 25 }) → { checkout_url }   // pay the URL
// 4. Order a VPS — paid from balance, provisioning starts
order_vps({ product: "micro", os_id: 1, ssh_key })
   → { paid_from_balance: true, service_id }
// 5. Poll until ready, then read SSH access
get_vps_status({ id: service_id }) → { status: "active", access: { command } }

REST-API

Jedes MCP-Tool wird von einem REST-Endpunkt gestützt, den du direkt aufrufen kannst. Basis-URL: https://api.eqvps.com

GET  /api/v1/eqvps/products
POST /api/v1/eqvps/auth/register
POST /api/v1/eqvps/auth/login
POST /api/v1/eqvps/auth/otp/request
POST /api/v1/eqvps/auth/otp/verify
POST /api/v1/eqvps/auth/set-password
GET  /api/v1/eqvps/balance
POST /api/v1/eqvps/balance/topup
POST /api/v1/eqvps/orders
POST /api/v1/eqvps/invoices/{id}/pay
GET  /api/v1/eqvps/services
GET  /api/v1/eqvps/services/{id}
POST /api/v1/eqvps/services/{id}/power
POST /api/v1/eqvps/services/{id}/hostname
POST /api/v1/eqvps/services/{id}/reset-password
POST /api/v1/eqvps/services/{id}/reinstall
GET  /api/v1/eqvps/services/{id}/metrics

Authentifizierte Endpunkte erfordern Authorization: Bearer <token>.