Ai-je besoin d'un client MCP ?

Non. C'est du REST simple sur HTTPS — utilisable depuis curl, n'importe quel langage, ou un agent qui parle HTTP. Si vous utilisez MCP, les mêmes actions sont exposées sous forme d'outils (voir le guide de connexion).

Comment fonctionne l'authentification ?

Appelez /auth/register pour obtenir un jeton Bearer (sans mot de passe). Envoyez-le dans l'en-tête Authorization: Bearer à chaque appel authentifié. /products est public.

Approvisionnez un solde prépayé via /balance/topup (renvoie une URL de paiement crypto ; payez en USDC/USDT). order débite ensuite le solde. Si non approvisionné, order renvoie une facture que vous payez via /invoices/{id}/pay.

Que contient la réponse de commande ?

Soit paid_from_balance avec un id de service (provisionnement démarré), soit une facture à payer. Interrogez GET /services/{id} jusqu'à ce que le statut soit active, puis lisez l'hôte SSH, le port et un mot de passe root à usage unique.

Commandez un VPS en 4 appels API (démarrage rapide REST pour agents)

Vous n'avez pas besoin d'un client MCP pour piloter EQVPS — l'API REST fait tout ce dont un agent a besoin. URL de base : https://api.eqvps.com/api/v1/eqvps. Voici tout le flux en quatre appels.

0. (une fois) Approvisionnez un solde prépayé

Pour que la commande soit un seul appel, approvisionnez d'abord un solde. Payez le paiement renvoyé en 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/..." }  ← payez-le en USDC/USDT

1. Inscription → jeton Bearer

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": {...} }

Pas de mot de passe, pas d'étape humaine. Stockez le jeton ; envoyez-le en Authorization: Bearer <YOUR_BEARER> ci-dessous.

2. Lister les offres → choisir product + os_id (public)

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" }, ... ] }, ... ] }

Choisissez un slug d'offre et un os_id parmi les available_os de cette offre.

3. Commander un VPS

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..."}'
# → payé depuis le solde : { "paid_from_balance": true, "service_id": <id> }
#   ou non approvisionné :  { "invoice": { "id": <id> } }  → payer : POST /invoices/{id}/pay → checkout_url

Passez une ssh_key (clé publique) pour une connexion root par clé. Avec un solde approvisionné, la commande est payée instantanément et le provisionnement démarre.

4. Lire l'accès

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": "<affiché une fois pour les serveurs sans clé>" , ... }

Interrogez jusqu'à ce que status soit active. Le bloc access contient l'hôte SSH, le port et une command prête à coller ; pour une commande sans clé, le password root à usage unique est renvoyé à la première lecture.

Notes pour les agents

Envoyez Authorization: Bearer <YOUR_BEARER> à chaque appel sauf /products.
Payez en USDC/USDT (Base, Ethereum, Polygon) — sans carte requise. Préférez le solde prépayé pour que l'étape 3 soit un seul appel.
Les actions sensibles (commande, réinitialisation du mot de passe, réinstallation, annulation) sont limitées en débit ; un usage normal reste largement dans les limites.
Vous préférez les outils au HTTP brut ? Les mêmes actions sont des outils MCP — voir le guide de connexion et la référence des outils. Documentation complète : /docs.