Le serveur MCP d'EQVPS expose 16 outils qui permettent à un agent IA de découvrir les offres, ouvrir un compte, payer en crypto et exploiter entièrement un VPS. Point de terminaison : https://mcp.eqvps.com/mcp (Streamable HTTP). Voir le guide de connexion pour le câbler dans votre client.
Modèle d'authentification : list_plans, register_account et login sont publics. Tout autre outil nécessite un jeton Bearer — obtenez-en un instantanément depuis register_account et envoyez-le en Authorization: Bearer <token>.
Découverte & authentification
| Outil | Auth | Paramètres | Ce qu'il fait |
|---|---|---|---|
list_plans | public | — | Liste toutes les offres VPS : tarifs, specs, et les images OS que chaque offre peut démarrer. Appelez ceci en premier pour choisir un product (slug) et un os_id. |
register_account | public | first_name, last_name, email | Crée un compte sans mot de passe et sans étape humaine. Renvoie un token Bearer. |
login | public | email, password | Connexion avec e-mail + mot de passe ; renvoie un token Bearer. |
whoami | Bearer | — | Renvoie le profil du compte authentifié (id, nom, e-mail). Vérifie le jeton. |
Solde & commande
| Outil | Auth | Paramètres | Ce qu'il fait |
|---|---|---|---|
get_balance | Bearer | — | Renvoie le solde de crédit prépayé et la devise. order_vps y puise automatiquement. |
topup_balance | Bearer | amount (USD, positif) | Crée une facture de recharge ; renvoie une checkout_url PayRam. Le solde est crédité une fois le paiement on-chain USDC/USDT confirmé. Une seule recharge impayée à la fois. |
order_vps | Bearer | product (slug d'offre), os_id (int), hostname?, ssh_key? | Commande un VPS. Passez une ssh_key (clé publique) pour un root par clé. Paie depuis le solde quand il suffit, sinon renvoie une facture à payer. |
pay_invoice | Bearer | invoice_id (int) | Lance le paiement d'une facture impayée vous appartenant. Renvoie une checkout_url PayRam ; le VPS se provisionne automatiquement une fois le paiement confirmé. |
Exploiter un VPS
| Outil | Auth | Paramètres | Ce qu'il fait |
|---|---|---|---|
list_vps | Bearer | — | Liste les services VPS du compte (id, statut, offre). Utilisez id comme service_id ci-dessous. |
get_vps_status | Bearer | service_id (int) | Détail complet : statut, specs, état/uptime en direct de la VM, et accès SSH (hôte, port, command prête à coller). Au premier appel pour un serveur sans clé, il renvoie le password root à usage unique. Interrogez après order_vps jusqu'à active. |
power_vps | Bearer | service_id, action = start | stop | reboot | Contrôle l'alimentation du VPS. |
set_hostname | Bearer | service_id, hostname | Définit le nom d'hôte du VPS (label DNS valide ; appliqué au prochain redémarrage/reconstruction). |
get_vps_metrics | Bearer | service_id, timeframe? = hour | day | week | month | Métriques CPU, mémoire, réseau et disque en séries temporelles (défaut hour). |
Destructifs — nécessitent confirm
Ceux-ci effacent des données ou des accès. confirm doit être égal au nom d'hôte exact (depuis get_vps_status) ou au littéral DELETE. Confirmez avec l'humain d'abord.
| Outil | Auth | Paramètres | Ce qu'il fait |
|---|---|---|---|
reset_password | Bearer | service_id, confirm | Renouvelle le mot de passe root. L'ANCIEN mot de passe cesse de fonctionner immédiatement. Le nouveau est lu une fois via get_vps_status (aussi envoyé par e-mail). |
reinstall_vps | Bearer | service_id, os_id (int), confirm | Efface et réinstalle avec l'image OS donnée — toutes les données sont perdues. Le provisionnement est asynchrone ; interrogez get_vps_status. |
cancel_service | Bearer | service_id, type? = end_of_period | immediate, confirm? | Par défaut end_of_period : reste actif jusqu'à la fin de la période payée, puis non renouvelé — sans perte de données. immediate détruit la VM et toutes les données maintenant (nécessite confirm = nom d'hôte) ; le temps payé non utilisé est remboursé sur votre solde (refund_amount). |
Exemple : commander et démarrer un VPS
list_plans() // choisir product "nano", noter un os_id
register_account({ first_name, last_name, email }) // → jeton Bearer
topup_balance({ amount: 10 }) // payer la checkout_url renvoyée en USDC/USDT
order_vps({ product: "nano", os_id: <os_id from list_plans>, ssh_key: "ssh-ed25519 AAAA..." })
get_vps_status({ service_id: <your-service-id> }) // interroger → active, lire hôte/port/command SSH
power_vps({ service_id: <your-service-id>, action: "reboot" })
Notes pour les agents
- Envoyez
Authorization: Bearer <token>à chaque appel non public. - Payez en USDC/USDT (Base, Ethereum, Polygon) — sans carte requise. Préférez un solde prépayé pour que la commande soit un seul appel.
- Appelez toujours
get_vps_statuspour lire les détails d'accès ; traitezreinstall_vps,reset_passwordetcancel_serviceimmédiat comme irréversibles.
Nouveau à la configuration ? Commencez par le guide de connexion, ou lisez la Documentation pour l'API REST sous-jacente.
Commentaires
Pas encore de commentaires. Soyez le premier.