Il server MCP di EQVPS (versione 1.9.1) ha 47 strumenti per un token cliente. Questa pagina copre i 23 che noleggiano e gestiscono un VPS: ogni parametro, il suo tipo e il valore predefinito, e alla fine una sequenza di chiamate da copiare. Endpoint: https://mcp.eqvps.com/mcp (Streamable HTTP). Prima volta? Parti dalla guida alla connessione.
Ultima verifica il 2026-10-20 sul server MCP 1.9.1 (tools/list).
Quale pagina ti serve? I parametri delle chiamate per i VPS sono in questa pagina. Tutti gli strumenti in un elenco, inclusi delega, supporto, sandbox e i 30 strumenti per rivenditori, sono nell'elenco completo. Cosa può fare un token trapelato e come limitare un agente è spiegato in MCP guardrails.
Autenticazione. list_plans, get_order_limits, register_account e login sono pubblici. Tutto il resto richiede Authorization: Bearer <token>. Nella stessa sessione MCP il token viene ricordato dopo register_account o login.
service_id è il codice del servizio restituito da order_vps o list_vps, per esempio 68J67T5. Va bene anche un id numerico.
Account e token
| Tool | Auth | Parameters | What it does |
|---|---|---|---|
list_plans | public | — | Piani con prezzi, specifiche e le immagini di OS che ciascuno avvia. plans[] contiene il plan_id mensile e annuale. Da chiamare per primo. |
register_account | public | first_name, last_name, email, token_ttl_days? (1–1825, predefinito 365) | Crea un account senza password e restituisce un token Bearer riutilizzabile con token_expires_at. Chiamalo una volta: una seconda chiamata crea un secondo account vuoto. |
login | public | email, password, token_ttl_days? | Restituisce un nuovo token. Funziona solo dopo set_password. |
refresh_token | Bearer | expires_in_days? (1–1825) | Emette un nuovo token e revoca subito quello attuale. Un token scaduto non si può rinnovare. |
set_password | Bearer | password (8+ caratteri, lettere e cifre) | Abilita login con email e password come riserva se perdi il token. Funziona una volta; una seconda chiamata restituisce 409. |
whoami | Bearer | — | id, nome ed email dell'account. Serve a verificare il token. |
Saldo e ordine
| Tool | Auth | Parameters | What it does |
|---|---|---|---|
get_balance | Bearer | — | Saldo prepagato e valuta. order_vps paga da qui. |
topup_balance | Bearer | amount (USD) | Crea una ricarica in cripto e restituisce una checkout_url. Il saldo viene accreditato quando il pagamento è confermato on-chain. Una sola ricarica non pagata alla volta. |
order_vps | Bearer | product, os_id, hostname?, ssh_key?, period? (month | year), plan_id?, location? (de | fi), quantity? (1–50), addons? (backups | extra_ipv4), idempotency_key? | Ordina un VPS e lo paga dal saldo se basta; altrimenti restituisce una fattura. Senza location scegliamo noi. I piani Windows ignorano ssh_key. Con quantity da 2 a 50 ricevi una fattura e altrettanti server separati; invia lo stesso idempotency_key quando riprovi. |
get_order_limits | public | product, period?, plan_id?, location?, addons? | Il massimo per ordine (max_quantity = 50, protezione dagli errori di battitura) e quali servizi aggiuntivi sono disponibili, con i prezzi. |
pay_invoice | Bearer | invoice_id | Restituisce una checkout_url per una fattura non pagata. Il VPS viene creato dopo il pagamento. |
Gestire un VPS
| Tool | Auth | Parameters | What it does |
|---|---|---|---|
list_vps | Bearer | — | Servizi attivi, in creazione e sospesi. Quelli eliminati non compaiono. |
get_vps_status | Bearer | service_id | Stato, specifiche, stato in tempo reale e accesso: host, porta e un command pronto (SSH per Linux, RDP per Windows). reveal_password restituisce la password di root monouso dopo l'avvio; password_pending: true significa: richiama tra 30–60 s. |
reveal_password | Bearer | service_id | Password root di un VPS senza chiave SSH, mostrata una sola volta. Mentre il server si avvia: password_pending: true, richiama dopo 30–60 s. |
power_vps | Bearer | service_id, action (start | stop | reboot) | Controllo dell'alimentazione. |
set_hostname | Bearer | service_id, hostname | Applicato nel server in funzione tramite il guest agent. Su Windows ha effetto dopo un riavvio (reboot_required: true). Se il server è spento, restituisce 409 agent_unavailable. |
get_vps_metrics | Bearer | service_id, timeframe? (hour | day | week | month, predefinito hour) | CPU, memoria, rete e disco nel tempo. |
Cambio piano e disdetta
| Tool | Auth | Parameters | What it does |
|---|---|---|---|
get_upgrade_options | Bearer | service_id | Piani a cui questo VPS può passare mantenendo i dati: un piano più grande, da NAT a IPv4 dedicato o da dedicato a NAT. Ogni opzione mostra prorated_topup, mode e capacity_now. Il disco non può ridursi. |
change_plan | Bearer | service_id, target_plan (product_id), confirm: true | Cambia piano sul posto con un riavvio di circa un minuto. La differenza proporzionale viene addebitata dal saldo (402 se non basta). |
cancel_service | Bearer | service_id, reason (3–500 caratteri, obbligatorio), type? (end_of_period | immediate), confirm? | Predefinito end_of_period: il server resta attivo fino alla fine del periodo pagato e non viene rinnovato. immediate distrugge subito il server, richiede confirm uguale all'hostname esatto; la risposta contiene il campo refund_amount. |
undo_cancel | Bearer | service_id | Rimuove una disdetta end_of_period programmata. Una disdetta immediata non si può annullare. |
Distruttivi: richiedono confirm
confirm è l'hostname esatto restituito da get_vps_status, oppure DELETE. Chiedi alla persona prima di chiamare.
| Tool | Auth | Parameters | What it does |
|---|---|---|---|
reset_password | Bearer | service_id, confirm | Una nuova password di root arriva sul server in funzione in 10–30 s e la vecchia smette di funzionare. Leggi la nuova una volta con reveal_password. Per una password persa, non per un server che si sta ancora avviando. |
reinstall_vps | Bearer | service_id, os_id, confirm | Cancella il disco e installa os_id. Tutti i dati vanno persi. Gira in background; interroga get_vps_status. |
Esempio: da zero a un server in funzione
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
Note per gli agenti
- Invia
Authorization: Bearer <token>in ogni chiamata tranne le tre pubbliche. Con HTTP semplice salva il token in un file: una variabile di shell non sopravvive tra comandi separati. - Leggi i dati di accesso da
get_vps_statusinvece di indovinare la porta. I piani NAT usano una porta personale; i piani con IPv4 dedicato usano 22 per Linux e 3389 per Windows. - Un nuovo server impiega circa un minuto ad avviarsi. Continua a interrogare
get_vps_status; non chiamarereset_passwordsolo perché SSH non ha risposto subito. topup_balanceepay_invoicerestituiscono un link di pagamento, che deve pagare una persona o un wallet. Monero è una ricarica manuale separata nella dashboard: vedi pagare con Monero.
Le stesse azioni senza MCP sono nella documentazione dell'API REST.
Commenti
Ancora nessun commento. Sii il primo.