REST API · MCP

API EQVPS

Inscrivez-vous, rechargez en crypto et commandez un VPS entièrement par code — sans KYC, sans humain dans la boucle. Conçu pour les développeurs et pour les agents IA qui provisionnent leurs propres serveurs.

OpenAPI 3.1MCP live · 45 toolsBearer authREST + MCP

URL de basehttps://api.eqvps.com/api/v1/eqvps

Essayer en direct Spécification OpenAPI Référence complète

Démarrage rapide

Quatre appels : de zéro à un VPS en marche. Les jetons ci-dessous sont des exemples — ne collez jamais un vrai jeton dans une page.

# 1. Inscription — renvoie un jeton Bearer (sans KYC, sans étape humaine)
curl -X POST https://api.eqvps.com/api/v1/eqvps/auth/register \
  -H "Content-Type: application/json" \
  -d '{"first_name":"Ada","last_name":"Agent","email":"agent@example.com"}'
# → { "token": "<YOUR_API_TOKEN>" }

# 2. Recharger le solde — payez en USDC / USDT / PYUSD, obtenez un lien de paiement
curl -X POST https://api.eqvps.com/api/v1/eqvps/balance/topup \
  -H "Authorization: Bearer <YOUR_API_TOKEN>" \
  -H "Content-Type: application/json" \
  -d '{"amount":20}'
# → { "checkout_url": "https://…" }   # payez on-chain, le solde est crédité automatiquement

# 3. Commander un VPS — payé depuis le solde (récupérez slug + os_id via GET /products)
curl -X POST https://api.eqvps.com/api/v1/eqvps/orders \
  -H "Authorization: Bearer <YOUR_API_TOKEN>" \
  -H "Content-Type: application/json" \
  -d '{"product":"micro","os_id":1,"ssh_key":"ssh-ed25519 AAAA…"}'

# 4. Lire l'accès SSH — le mot de passe root à usage unique s'affiche ici une seule fois
curl https://api.eqvps.com/api/v1/eqvps/services/SV-XXXXXX \
  -H "Authorization: Bearer <YOUR_API_TOKEN>"
# → { "status":"active", "ssh": { "host":"…", "port":22, "command":"ssh root@… -p 22" } }

Points de terminaison clés

La surface principale. Ouvrez l'explorateur interactif pour chaque paramètre et réponse.

POST/auth/registerCréez un compte et obtenez un jeton Bearer. Sans mot de passe, sans étape humaine.

GET/productsListez toutes les offres VPS avec les specs, le prix et les images OS prises en charge.

POST/balance/topupCréez une facture de recharge crypto ; renvoie une URL de paiement. Le solde est crédité à la confirmation on-chain.

POST/ordersCommandez un VPS. Payé depuis le solde s'il est approvisionné, sinon renvoie une facture impayée.

GET/services/{id}Statut complet + accès SSH en direct. Le mot de passe root à usage unique apparaît ici une seule fois.

GET/balanceSolde de crédit prépayé et devise.

Voir chaque point de terminaison, paramètre et schéma dans l'explorateur interactif →

Pour les agents IA

Un agent peut passer de rien à un serveur opérationnel tout seul — découvrir, payer, provisionner et lire le SSH, le tout via l'API ou MCP.

MCP est en production — pas prévu.

Pointez n'importe quel client MCP vers https://mcp.eqvps.com/mcp (Streamable HTTP). 45 outils couvrent la découverte, le compte, le paiement et le contrôle complet du VPS. Outils publics : list_plans, register_account, login ; tout le reste nécessite un jeton Bearer.

Flux autonome

1. register_account → obtenir un jeton Bearer
2. topup_balance → payer l'URL de paiement en USDC/USDT
3. order_vps → provisionner depuis le solde
4. get_vps_status → interroger jusqu'à l'état actif, lire le SSH (hôte, port, commande, mot de passe à usage unique)

Ressources lisibles par machine

agent.jsonProfil machine — offres, points de terminaison, statut MCP.mcp.jsonManifeste MCP — URL du serveur et liste des outils.llms.txtGuide LLM concis avec un exemple de bout en bout.llms-full.txtRéférence LLM étendue.openapi.jsonSpécification OpenAPI 3.1 (alimente l'explorateur).

Sandboxes de code pour agents IA

Des microVM Linux isolées qui démarrent en une seconde environ et exécutent Python, Node.js et le shell pour vos agents. Facturées à la seconde sur le même solde crypto, dès $0.0165 de l'heure. Lancement via SDK, MCP ou REST.

pip install eqvps          # Python
npm i @eqvps/sdk           # TypeScript / JavaScript
# MCP: create_sandbox -> run_code / exec_command -> kill_sandbox

Essayer les sandboxes — $1 offert →Docs des sandboxes et SDK →

Erreurs

Codes de statut HTTP standard. En cas d'échec, le corps contient un champ message.

StatutSignification

200 / 201OK — requête réussie / ressource créée.

401Jeton Bearer manquant ou invalide.

403Authentifié, mais vous n'êtes pas le propriétaire de cette ressource.

404Ressource introuvable.

409Conflit d'état (ex. une recharge impayée existe déjà).

422Erreur de validation — vérifiez le corps de la requête.

429Limite de débit atteinte — patientez et réessayez.

Limites de débit

Les actions sensibles (commande, recharge, réinitialisation du mot de passe, réinstallation, console) sont limitées par compte. Une automatisation normale reste largement dans les limites ; en cas de 429, patientez et réessayez.

Développez dessus dès maintenant

Récupérez la spécification, ouvrez l'explorateur, ou lisez la référence complète avec la configuration MCP.

Ouvrir l'explorateur Lire la documentation