Il server MCP di EQVPS espone 16 strumenti che permettono a un agente IA di scoprire i piani, aprire un account, pagare in crypto e gestire completamente un VPS. Endpoint: https://mcp.eqvps.com/mcp (Streamable HTTP). Vedi la guida alla connessione per collegarlo al tuo client.
Modello di auth: list_plans, register_account e login sono pubblici. Ogni altro strumento richiede un token Bearer — ottienine uno all'istante da register_account e invialo come Authorization: Bearer <token>.
Discovery e auth
| Strumento | Auth | Parametri | Cosa fa |
|---|---|---|---|
list_plans | pubblico | — | Elenca tutti i piani VPS: prezzi, specifiche e le immagini OS che ogni piano può avviare. Chiamalo per primo per scegliere uno slug product e un os_id. |
register_account | pubblico | first_name, last_name, email | Crea un account senza password e senza passo umano. Restituisce un token Bearer. |
login | pubblico | email, password | Accedi con email + password; restituisce un token Bearer. |
whoami | Bearer | — | Restituisce il profilo dell'account autenticato (id, nome, email). Verifica il token. |
Saldo e ordini
| Strumento | Auth | Parametri | Cosa fa |
|---|---|---|---|
get_balance | Bearer | — | Restituisce il saldo di credito prepagato e la valuta. order_vps spende da lì automaticamente. |
topup_balance | Bearer | amount (USD, positivo) | Crea una fattura di ricarica; restituisce un checkout_url PayRam. Il saldo viene accreditato una volta che il pagamento on-chain in USDC/USDT conferma. Una ricarica non pagata alla volta. |
order_vps | Bearer | product (slug del piano), os_id (int), hostname?, ssh_key? | Ordina un VPS. Passa una ssh_key (chiave pubblica) per il login root basato su chiave. Paga dal saldo quando sufficiente, altrimenti restituisce una fattura da pagare. |
pay_invoice | Bearer | invoice_id (int) | Avvia il pagamento di una fattura posseduta e non pagata. Restituisce un checkout_url PayRam; il VPS viene creato automaticamente una volta confermato il pagamento. |
Gestire un VPS
| Strumento | Auth | Parametri | Cosa fa |
|---|---|---|---|
list_vps | Bearer | — | Elenca i servizi VPS dell'account (id, stato, piano). Usa id come service_id sotto. |
get_vps_status | Bearer | service_id (int) | Dettaglio completo: stato, specifiche, stato/uptime live della VM, e accesso SSH (host, porta, command pronto da incollare). Alla prima chiamata per un server senza chiave restituisce la password root una tantum. Fai polling dopo order_vps finché è active. |
power_vps | Bearer | service_id, action = start | stop | reboot | Controllo dell'alimentazione del VPS. |
set_hostname | Bearer | service_id, hostname | Imposta l'hostname del VPS (etichetta DNS valida; applicata al prossimo riavvio/ricostruzione). |
get_vps_metrics | Bearer | service_id, timeframe? = hour | day | week | month | Metriche time-series di CPU, memoria, rete e disco (default hour). |
Distruttivi — richiedono confirm
Questi cancellano dati o accesso. confirm deve essere uguale all'hostname esatto (da get_vps_status) o al letterale DELETE. Conferma prima con l'umano.
| Strumento | Auth | Parametri | Cosa fa |
|---|---|---|---|
reset_password | Bearer | service_id, confirm | Ruota la password root. La VECCHIA password smette di funzionare immediatamente. La nuova password si legge una volta via get_vps_status (inviata anche via email). |
reinstall_vps | Bearer | service_id, os_id (int), confirm | Cancella e reinstalla con l'immagine OS data — tutti i dati vanno persi. Il provisioning è asincrono; fai polling di get_vps_status. |
cancel_service | Bearer | service_id, type? = end_of_period | immediate, confirm? | Default end_of_period: resta attivo fino alla fine del periodo pagato, poi non viene rinnovato — nessuna perdita di dati. immediate distrugge la VM e tutti i dati ora (richiede confirm = hostname); il tempo pagato non usato viene rimborsato sul tuo saldo (refund_amount). |
Esempio: ordina e avvia un VPS
list_plans() // scegli il product "nano", nota un os_id
register_account({ first_name, last_name, email }) // → token Bearer
topup_balance({ amount: 10 }) // paga il checkout_url restituito in 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> }) // polling → active, leggi host/porta/command SSH
power_vps({ service_id: <your-service-id>, action: "reboot" })
Note per gli agenti
- Invia
Authorization: Bearer <token>su ogni chiamata non pubblica. - Paga in USDC/USDT (Base, Ethereum, Tron) — nessuna carta richiesta. Preferisci un saldo prepagato così l'ordine è una sola chiamata.
- Chiama sempre
get_vps_statusper leggere i dettagli di accesso; trattareinstall_vps,reset_passwordecancel_serviceimmediato come irreversibili.
Nuovo al setup? Inizia con la guida alla connessione, o leggi la Documentazione per l'API REST sottostante.
Commenti
Ancora nessun commento. Sii il primo.