Le serveur MCP EQVPS (version 1.6.0) propose 45 outils pour un jeton client. Cette page couvre les 21 qui louent et pilotent un VPS : chaque paramètre, son type et sa valeur par défaut, puis une séquence d'appels à copier à la fin. Endpoint : https://mcp.eqvps.com/mcp (Streamable HTTP). Première fois ? Commencez par le guide de connexion.
Dernière vérification le 2026-10-04 sur le serveur MCP 1.6.0 (tools/list).
De quelle page avez-vous besoin ? Les paramètres des appels VPS sont sur cette page. Tous les outils en une liste, y compris délégation, support, sandboxes et les 30 outils revendeur, sont dans la liste complète. Ce qu'un jeton divulgué permet et comment limiter un agent est expliqué dans MCP guardrails.
Authentification. list_plans, register_account et login sont publics. Tout le reste exige Authorization: Bearer <token>. Dans une même session MCP, le jeton est mémorisé après register_account ou login.
service_id est le code de service renvoyé par order_vps ou list_vps, par exemple 68J67T5. Un id numérique fonctionne aussi.
Compte et jeton
| Tool | Auth | Parameters | What it does |
|---|---|---|---|
list_plans | public | — | Offres avec prix, caractéristiques et images d'OS que chacune peut démarrer. plans[] contient le plan_id mensuel et annuel. À appeler en premier. |
register_account | public | first_name, last_name, email, token_ttl_days? (1–1825, par défaut 365) | Crée un compte sans mot de passe et renvoie un token Bearer réutilisable avec token_expires_at. Une seule fois : un second appel crée un second compte, vide. |
login | public | email, password, token_ttl_days? | Renvoie un nouveau jeton. Ne fonctionne qu'après set_password. |
refresh_token | Bearer | expires_in_days? (1–1825) | Émet un nouveau jeton et révoque immédiatement l'actuel. Un jeton expiré ne peut pas être renouvelé. |
set_password | Bearer | password (8 caractères ou plus, lettres et chiffres) | Active login par e-mail et mot de passe en secours si le jeton est perdu. Une seule fois ; un second appel renvoie 409. |
whoami | Bearer | — | id, nom et e-mail du compte. Sert à vérifier le jeton. |
Solde et commande
| Tool | Auth | Parameters | What it does |
|---|---|---|---|
get_balance | Bearer | — | Solde prépayé et devise. order_vps paie à partir de ce solde. |
topup_balance | Bearer | amount (USD) | Crée une recharge en crypto et renvoie une checkout_url. Le solde est crédité quand le paiement est confirmé on-chain. Une seule recharge impayée à la fois. |
order_vps | Bearer | product, os_id, hostname?, ssh_key?, period? (month | year), plan_id?, location? (de | fi) | Commande un VPS et le paie sur le solde s'il suffit ; sinon renvoie une facture. Sans location, nous choisissons. Un emplacement sans capacité libre renvoie 409 location_unavailable avec une liste available, et rien n'est débité. Les offres Windows ignorent ssh_key. |
pay_invoice | Bearer | invoice_id | Renvoie une checkout_url pour une facture impayée. Le VPS est créé une fois payé. |
Piloter un VPS
| Tool | Auth | Parameters | What it does |
|---|---|---|---|
list_vps | Bearer | — | Services actifs, en cours de création et suspendus. Les supprimés n'apparaissent pas. |
get_vps_status | Bearer | service_id, reveal? | Statut, caractéristiques, état en direct et accès : hôte, port et une command prête (SSH pour Linux, RDP pour Windows). reveal: true renvoie le mot de passe root à usage unique après le démarrage ; password_pending: true signifie : rappelez dans 30 à 60 s. |
power_vps | Bearer | service_id, action (start | stop | reboot) | Contrôle de l'alimentation. |
set_hostname | Bearer | service_id, hostname | Appliqué dans le serveur en marche via l'agent invité. Sous Windows, il prend effet après un redémarrage (reboot_required: true). Si le serveur est éteint, renvoie 409 agent_unavailable. |
get_vps_metrics | Bearer | service_id, timeframe? (hour | day | week | month, par défaut hour) | CPU, mémoire, réseau et disque dans le temps. |
Changement d'offre et résiliation
| Tool | Auth | Parameters | What it does |
|---|---|---|---|
get_upgrade_options | Bearer | service_id | Offres vers lesquelles ce VPS peut passer en gardant ses données : une offre plus grande, NAT vers IPv4 dédiée ou dédiée vers NAT. Chaque option affiche prorated_topup et mode. Un disque ne peut pas rétrécir. |
change_plan | Bearer | service_id, target_plan (product_id), confirm: true | Change l'offre sur place avec un redémarrage d'environ une minute. La différence au prorata est débitée du solde (402 s'il est insuffisant) ; un passage en NAT rembourse la différence. |
cancel_service | Bearer | service_id, reason (3 à 500 caractères, obligatoire), type? (end_of_period | immediate), confirm? | Par défaut end_of_period : le serveur tourne jusqu'à la fin de la période payée et n'est pas renouvelé. immediate détruit le serveur tout de suite, exige confirm égal au hostname exact et rembourse le temps non utilisé sur le solde (refund_amount). |
undo_cancel | Bearer | service_id | Annule une résiliation end_of_period programmée. Une résiliation immédiate ne peut pas être annulée. |
Destructifs : ils exigent confirm
confirm est le hostname exact donné par get_vps_status, ou DELETE. Demandez à l'humain avant l'appel.
| Tool | Auth | Parameters | What it does |
|---|---|---|---|
reset_password | Bearer | service_id, confirm | Un nouveau mot de passe root arrive sur le serveur en marche en 10 à 30 s et l'ancien cesse de fonctionner. Lisez le nouveau une fois avec get_vps_status (reveal: true). Pour un mot de passe perdu, pas pour un serveur qui démarre encore. |
reinstall_vps | Bearer | service_id, os_id, confirm | Efface le disque et installe os_id. Toutes les données sont perdues. S'exécute en arrière-plan ; interrogez get_vps_status. |
Exemple : de zéro à un serveur qui tourne
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
Notes pour les agents
- Envoyez
Authorization: Bearer <token>à chaque appel, sauf les trois publics. En HTTP brut, enregistrez le jeton dans un fichier : une variable shell ne survit pas d'une commande à l'autre. - Lisez les accès dans
get_vps_statusau lieu de deviner le port. Les offres NAT utilisent un port personnel ; les offres avec IPv4 dédiée utilisent 22 pour Linux et 3389 pour Windows. - Un nouveau serveur met environ une minute à démarrer. Continuez à interroger
get_vps_status; n'appelez pasreset_passwordparce que SSH n'a pas répondu tout de suite. topup_balanceetpay_invoicerenvoient un lien de paiement, qu'une personne ou un wallet doit régler. Monero est une recharge manuelle séparée dans le tableau de bord : voir payer en Monero.
Les mêmes actions sans MCP sont décrites dans la documentation de l'API REST.
Commentaires
Pas encore de commentaires. Soyez le premier.