EQVPS MCP server AI agent ዕቅዶችን እንዲያገኝ፣ መለያ እንዲከፍት፣ በcrypto እንዲከፍል፣ እና VPSን ሙሉ በሙሉ እንዲያሄድ የሚያስችሉ 16 tools ያጋልጣል። Endpoint: https://mcp.eqvps.com/mcp (Streamable HTTP)። ወደ clientዎ ለማገናኘት connect guide ይመልከቱ።
Auth model: list_plans፣ register_account እና login ሕዝባዊ ናቸው። ሌላው እያንዳንዱ tool Bearer token ይፈልጋል — ከregister_account ወዲያውኑ አንዱን ያግኙ እና እንደ Authorization: Bearer <token> ይላኩት።
Discovery & auth
| Tool | Auth | Parameters | ምን እንደሚያደርግ |
|---|---|---|---|
list_plans | ሕዝባዊ | — | ሁሉንም VPS ዕቅዶች ይዘርዝራል: pricing፣ specs፣ እና እያንዳንዱ ዕቅድ ማስነሳት የሚችላቸው OS images። product slug እና os_id ለመምረጥ ይህን መጀመሪያ ይጥሩ። |
register_account | ሕዝባዊ | first_name, last_name, email | ያለ password እና ያለ የሰው እርምጃ መለያ ይፈጥራል። Bearer token ይመልሳል። |
login | ሕዝባዊ | email, password | በemail + password ይግቡ፤ Bearer token ይመልሳል። |
whoami | Bearer | — | የauthenticated መለያ profile ይመልሳል (id፣ ስም፣ email)። tokenን ያረጋግጣል። |
ቀሪ ሂሳብ & ማዘዝ
| Tool | Auth | Parameters | ምን እንደሚያደርግ |
|---|---|---|---|
get_balance | Bearer | — | ቅድመ-ክፍያ credit ቀሪ ሂሳብ እና ምንዛሪ ይመልሳል። order_vps ከእሱ በራስ-ሰር ያወጣል። |
topup_balance | Bearer | amount (USD፣ አዎንታዊ) | top-up invoice ይፈጥራል፤ PayRam checkout_url ይመልሳል። on-chain USDC/USDT ክፍያ ሲረጋገጥ ቀሪ ሂሳብ ይሞላል። በአንድ ጊዜ አንድ ያልተከፈለ top-up። |
order_vps | Bearer | product (plan slug), os_id (int), hostname?, ssh_key? | VPS ያዛል። ለkey-based root login ssh_key (public key) ያስተላልፉ። በቂ ሲሆን ከቀሪ ሂሳብ ይከፍላል፣ አለበለዚያ ሊከፍሉት invoice ይመልሳል። |
pay_invoice | Bearer | invoice_id (int) | ለተያዘ፣ ያልተከፈለ invoice ክፍያ ይጀምራል። PayRam checkout_url ይመልሳል፤ ክፍያ ሲረጋገጥ VPS በራስ-ሰር ይቀርባል። |
VPS ማሄድ
| Tool | Auth | Parameters | ምን እንደሚያደርግ |
|---|---|---|---|
list_vps | Bearer | — | የመለያውን VPS services ይዘርዝራል (id፣ status፣ plan)። idን ከታች እንደ service_id ይጠቀሙ። |
get_vps_status | Bearer | service_id (int) | ሙሉ ዝርዝር: status፣ specs፣ live VM state/uptime፣ እና SSH መዳረሻ (host፣ port፣ ready-to-paste command)። ለkeyless server በመጀመሪያ ጥሪ የአንድ-ጊዜ root password ይመልሳል። ከorder_vps በኋላ እስከ active ይመልከቱ። |
power_vps | Bearer | service_id, action = start | stop | reboot | VPSን power-control ያድርጉ። |
set_hostname | Bearer | service_id, hostname | የVPS hostname ያዘጋጁ (ትክክለኛ DNS label፤ በሚቀጥለው reboot/rebuild ላይ የተተገበረ)። |
get_vps_metrics | Bearer | service_id, timeframe? = hour | day | week | month | Time-series CPU፣ memory፣ network፣ እና disk metrics (ነባሪ hour)። |
Destructive — confirm ይፈልጋሉ
እነዚህ data ወይም መዳረሻ ይሰርዛሉ። confirm ከትክክለኛው hostname (ከget_vps_status) ወይም ከቃል በቃል DELETE ጋር እኩል መሆን አለበት። መጀመሪያ ከሰው ጋር ያረጋግጡ።
| Tool | Auth | Parameters | ምን እንደሚያደርግ |
|---|---|---|---|
reset_password | Bearer | service_id, confirm | root password ያዞራል። አሮጌው password ወዲያውኑ መሥራት ያቆማል። አዲስ password በget_vps_status አንድ ጊዜ ይነበባል (እንዲሁም በemail ይላካል)። |
reinstall_vps | Bearer | service_id, os_id (int), confirm | በተሰጠው OS image ይሰርዛል እና እንደገና ይጭናል — ሁሉም data ይጠፋል። Provisioning async ነው፤ get_vps_status ይመልከቱ። |
cancel_service | Bearer | service_id, type? = end_of_period | immediate, confirm? | ነባሪ end_of_period: የተከፈለው ጊዜ እስኪያልቅ ንቁ ይቆያል፣ ከዚያ አይታደስም — የdata ኪሳራ የለም። immediate VMን እና ሁሉንም data አሁን ያጠፋል (confirm = hostname ይፈልጋል)፤ ያልተጠቀሙበት የተከፈለ ጊዜ ወደ ቀሪ ሂሳብዎ ተመላሽ ይደረጋል (refund_amount)። |
ምሳሌ: VPS ማዘዝ እና ማስነሳት
list_plans() // pick product "nano", note an os_id
register_account({ first_name, last_name, email }) // → Bearer token
topup_balance({ amount: 10 }) // pay the returned checkout_url 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> }) // poll → active, read SSH host/port/command
power_vps({ service_id: <your-service-id>, action: "reboot" })
ለagents ማስታወሻዎች
- በእያንዳንዱ ሕዝባዊ-ያልሆነ ጥሪ ላይ
Authorization: Bearer <token>ይላኩ። - በUSDC/USDT (Base፣ Ethereum፣ Tron) ይክፈሉ — ካርድ አያስፈልግም። ማዘዝ አንድ ጥሪ እንዲሆን ቅድመ-ክፍያ ቀሪ ሂሳብ ይምረጡ።
- መዳረሻ ዝርዝሮችን ለማንበብ ሁልጊዜ
get_vps_status፤reinstall_vps፣reset_password፣ እና immediatecancel_serviceን እንደ የማይቀለበስ ይያዙ።
ከsetup አዲስ ኖት? በconnect guide ይጀምሩ፣ ወይም ለመሠረታዊ REST API Docs ያንብቡ።
አስተያየቶች
እስካሁን አስተያየቶች የሉም። መጀመሪያ ይሁኑ።