Mi serve un client MCP?

No. Questo è REST semplice su HTTPS — utilizzabile da curl, da qualsiasi linguaggio o da un agente che parla HTTP. Se usi MCP, le stesse azioni sono esposte come strumenti (vedi la guida alla connessione).

Come funziona l'auth?

Chiama /auth/register per ottenere un token Bearer (nessuna password). Invialo come header Authorization: Bearer su ogni chiamata autenticata. /products è pubblico.

Finanzia un saldo prepagato tramite /balance/topup (restituisce un URL di checkout in crypto; paga in USDC/USDT). order addebita poi il saldo. Se non finanziato, order restituisce una fattura che paghi tramite /invoices/{id}/pay.

Cosa contiene la risposta dell'ordine?

O paid_from_balance con un id di servizio (provisioning avviato), o una fattura da pagare. Fai polling di GET /services/{id} finché lo status è active, poi leggi l'host SSH, la porta e una password root una tantum.

Ordina un VPS in 4 chiamate API (guida rapida REST per agenti)

Non ti serve un client MCP per pilotare EQVPS — l'API REST fa tutto ciò di cui un agente ha bisogno. URL di base: https://api.eqvps.com/api/v1/eqvps. Ecco l'intero flusso in quattro chiamate.

0. (una volta) Finanzia un saldo prepagato

Così che ordinare sia una singola chiamata, finanzia prima un saldo. Paga il checkout restituito in 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/..." }  ← pagalo in USDC/USDT

1. Registrati → token 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": {...} }

Nessuna password, nessun passo umano. Conserva il token; invialo come Authorization: Bearer <YOUR_BEARER> sotto.

2. Elenca i piani → scegli product + os_id (pubblico)

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

Scegli uno slug di piano e un os_id dagli available_os di quel piano.

3. Ordina 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..."}'
# → pagato dal saldo: { "paid_from_balance": true, "service_id": <id> }
#   o non finanziato: { "invoice": { "id": <id> } }  → paga: POST /invoices/{id}/pay → checkout_url

Passa una ssh_key (chiave pubblica) per il login root basato su chiave. Con un saldo finanziato l'ordine è pagato all'istante e il provisioning parte.

4. Leggi l'accesso

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": "<shown once for keyless servers>" , ... }

Fai polling finché lo status è active. Il blocco access ha l'host SSH, la porta e un command pronto da incollare; per un ordine senza chiave la password root una tantum viene restituita alla prima lettura.

Note per gli agenti

Invia Authorization: Bearer <YOUR_BEARER> su ogni chiamata tranne /products.
Paga in USDC/USDT (Base, Ethereum, Tron) — nessuna carta richiesta. Preferisci il saldo prepagato così il passo 3 è una sola chiamata.
Le azioni sensibili (order, reset-password, reinstall, cancel) sono rate-limited; l'uso normale è ben entro i limiti.
Preferisci strumenti all'HTTP grezzo? Le stesse azioni sono strumenti MCP — vedi la guida alla connessione e il riferimento degli strumenti. Documentazione completa: /docs.