−25%

la planurile Windows anuale, până pe 31 oct. Vezi planurile

EQVPS
Începe

Uneltele MCP EQVPS pentru un VPS: parametri și exemple de apeluri

10 iun. 2026 · 6 min de citit · EQVPS

Serverul MCP EQVPS (versiunea 1.6.0) are 45 de unelte pentru un token de client. Pagina de față acoperă cele 21 care închiriază și rulează un VPS: fiecare parametru, tipul și valoarea lui implicită și, la final, o secvență de apeluri pe care o poți copia. Endpoint: https://mcp.eqvps.com/mcp (Streamable HTTP). Ești nou? Începe cu ghidul de conectare.

Verificat ultima dată pe 2026-10-04, pe serverul MCP 1.6.0 (tools/list).

De ce pagină ai nevoie? Parametrii apelurilor VPS sunt pe pagina de față. Toate uneltele într-o singură listă, inclusiv delegarea, suportul, sandboxurile și cele 30 de unelte pentru reselleri, sunt în lista completă. Ce poate face un token scurs și cum limitezi un agent e în MCP guardrails.

Autentificarea. list_plans, register_account și login sunt publice. Toate celelalte au nevoie de Authorization: Bearer <token>. Într-o sesiune MCP, tokenul e reținut după register_account sau login.

service_id e codul serviciului din order_vps sau list_vps, de exemplu 68J67T5. Merge și un id numeric.

Contul și tokenul

UnealtaAutentificareParametriCe face
list_planspublică—Planurile cu prețuri, specificații și imaginile de OS pe care le poate porni fiecare. plans[] conține plan_id lunar și anual. Apeleaz-o prima.
register_accountpublicăfirst_name, last_name, email, token_ttl_days? (1–1825, implicit 365)Creează un cont fără parolă și returnează un token Bearer refolosibil, cu token_expires_at. Apeleaz-o o singură dată: un al doilea apel creează un al doilea cont, gol.
loginpublicăemail, password, token_ttl_days?Returnează un token nou. Merge doar după set_password.
refresh_tokenBearerexpires_in_days? (1–1825)Emite un token nou și îl revocă imediat pe cel curent. Un token expirat nu poate fi reîmprospătat.
set_passwordBearerpassword (8+ caractere, litere și cifre)Pornește login cu e-mail și parolă, ca rezervă dacă se pierde tokenul. Merge o singură dată; un al doilea apel returnează 409.
whoamiBearer—Id-ul contului, numele și e-mailul. Folosește-o ca să verifici tokenul.

Soldul și comanda

UnealtaAutentificareParametriCe face
get_balanceBearer—Soldul preplătit și moneda. order_vps cheltuie din el.
topup_balanceBeareramount (USD)Creează o alimentare cu cripto și returnează un checkout_url. Soldul e creditat când plata e confirmată on-chain. O singură alimentare neplătită deodată.
order_vpsBearerproduct, os_id, hostname?, ssh_key?, period? (month | year), plan_id?, location? (de | fi)Comandă un VPS și plătește din sold când acesta acoperă prețul; altfel returnează o factură. Fără location, alegem noi una. O locație fără capacitate liberă returnează 409 location_unavailable cu o listă available, iar nimic nu e taxat. Planurile Windows ignoră ssh_key.
pay_invoiceBearerinvoice_idReturnează un checkout_url pentru o factură neplătită. VPS-ul e creat după plată.

Operarea unui VPS

UnealtaAutentificareParametriCe face
list_vpsBearer—Serviciile active, în pregătire și suspendate. Cele șterse nu sunt listate.
get_vps_statusBearerservice_id, reveal?Starea, specificațiile, starea live și accesul: host, port și o command gata de folosit (SSH pentru Linux, RDP pentru Windows). reveal: true returnează parola root, o singură dată, după pornire; password_pending: true înseamnă să apelezi din nou peste 30–60 s.
power_vpsBearerservice_id, action (start | stop | reboot)Controlul alimentării.
set_hostnameBearerservice_id, hostnameAplicat în serverul pornit prin guest agent. Pe Windows intră în vigoare după o repornire (reboot_required: true). Dacă serverul e oprit, returnează 409 agent_unavailable.
get_vps_metricsBearerservice_id, timeframe? (hour | day | week | month, implicit hour)CPU, memorie, rețea și disc în timp.

Schimbarea planului și anularea

UnealtaAutentificareParametriCe face
get_upgrade_optionsBearerservice_idPlanurile pe care se poate muta acest VPS cu datele păstrate: un plan mai mare, de la NAT la IPv4 dedicat sau de la dedicat la NAT. Fiecare opțiune arată prorated_topup și mode. Un disc nu se poate micșora.
change_planBearerservice_id, target_plan (product_id), confirm: trueSchimbă planul pe loc, cu o repornire de aproximativ un minut. Diferența proporțională e taxată din sold (402 dacă nu ajunge); la trecerea pe NAT, diferența revine în sold.
cancel_serviceBearerservice_id, reason (3–500 de caractere, obligatoriu), type? (end_of_period | immediate), confirm?Implicit end_of_period: serverul rulează până se încheie perioada plătită și nu e reînnoit. immediate distruge serverul acum, cere confirm setat exact la numele de host și trece timpul nefolosit înapoi în sold.
undo_cancelBearerservice_idElimină o anulare end_of_period programată. Una imediată nu poate fi anulată.

Distructive: acestea au nevoie de confirm

confirm e numele de host exact din get_vps_status sau DELETE. Întreabă omul înainte să apelezi.

UnealtaAutentificareParametriCe face
reset_passwordBearerservice_id, confirmO parolă root nouă ajunge în serverul pornit în 10–30 s, iar cea veche nu mai merge. Citește-o pe cea nouă o singură dată cu get_vps_status (reveal: true). Folosește-o pentru o parolă pierdută, nu pentru un server care încă pornește.
reinstall_vpsBearerservice_id, os_id, confirmȘterge discul și instalează os_id. Toate datele se pierd. Rulează în fundal; interoghează get_vps_status.

Exemplu: de la zero la un server care rulează

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 pentru agenți

  • Trimite Authorization: Bearer <token> la fiecare apel, cu excepția celor trei publice. Cu HTTP simplu, salvează tokenul într-un fișier: o variabilă de shell nu supraviețuiește între comenzi separate.
  • Citește datele de acces din get_vps_status în loc să ghicești portul. Planurile NAT folosesc un port personal; planurile cu IPv4 dedicat folosesc 22 pentru Linux și 3389 pentru Windows.
  • Un server nou are nevoie de aproximativ un minut ca să pornească. Interoghează în continuare get_vps_status; nu apela reset_password doar pentru că SSH-ul n-a răspuns imediat.
  • topup_balance și pay_invoice returnează un link de plată, iar o persoană sau un portofel trebuie să-l plătească. Monero e o alimentare manuală separată, din panou: vezi plata cu Monero.

Aceleași acțiuni fără MCP sunt în documentația REST API.

Întrebări frecvente

Cum apelez aceste unelte?

Conectează un client MCP la https://mcp.eqvps.com/mcp (Streamable HTTP) și apelează o unealtă după nume, cu parametrii din tabele. Configurarea pentru Claude Desktop, Cursor și alți clienți e în ghidul de conectare.

Ce unelte merg fără token?

list_plans, register_account și login. Toate celelalte unelte de pe pagină au nevoie de Authorization: Bearer <token>. register_account returnează un token valabil implicit 365 de zile.

Ce e service_id?

Codul serviciului returnat de order_vps și list_vps, de exemplu 68J67T5. E acceptat și un id numeric simplu.

Cum obține un agent parola root?

Apelează get_vps_status cu reveal: true după ce serverul a pornit. Parola e afișată o singură dată. Dacă răspunsul spune password_pending: true, serverul încă pornește: apelează din nou peste 30–60 de secunde. Dacă ai trimis un ssh_key la comandă, autentifică-te cu cheia.

Ce apeluri nu pot fi anulate?

reinstall_vps și cancel_service cu tipul immediate distrug toate datele, iar reset_password înlocuiește parola veche. Au nevoie de confirm setat exact la numele de host; reinstall și reset acceptă și DELETE. Întreabă omul înainte să le apelezi.

Comentarii

Încă nu există comentarii. Fii primul.

Lasă un comentariu

Comentariile sunt moderate înainte să apară.