د EQVPS MCP سرور ۱۶ وسیلې څرګندوي چې یو AI اجنټ ته اجازه ورکوي چې پلانونه کشف کړي، یو حساب پرانیزي، په crypto تادیه وکړي، او په بشپړه توګه یو VPS وچلوي. Endpoint: https://mcp.eqvps.com/mcp (Streamable HTTP). د دې خپل client ته د نښلولو لپاره د نښلولو لارښود وګورئ.
د Auth مودل: list_plans، register_account، او login عامه دي. هره بله وسیله یو Bearer token ته اړتیا لري — یو یې سمدلاسه له register_account څخه ترلاسه کړئ او د Authorization: Bearer <token> په توګه یې واستوئ.
کشف او auth
| وسیله | Auth | پارامترونه | څه کوي |
|---|---|---|---|
list_plans | عامه | — | ټول VPS پلانونه فهرست کوي: بیه، مشخصات، او هغه OS تصویرونه چې هر پلان یې بوټولی شي. لومړی یې وبلئ ترڅو یو product slug او os_id وټاکئ. |
register_account | عامه | first_name، last_name، email | د یوه پټنوم او یوه انساني ګام پرته یو حساب جوړوي. یو Bearer token راګرځوي. |
login | عامه | email، password | د بریښنالیک + پټنوم سره ننوځئ؛ یو Bearer token راګرځوي. |
whoami | Bearer | — | د تصدیق شوي حساب پروفایل راګرځوي (id، نوم، بریښنالیک). token تصدیقوي. |
بیلانس او امر
| وسیله | Auth | پارامترونه | څه کوي |
|---|---|---|---|
get_balance | Bearer | — | مخکې-تادیه شوی د اعتبار بیلانس او اسعارو راګرځوي. order_vps په اتوماتیک ډول له هغه لګوي. |
topup_balance | Bearer | amount (USD، مثبت) | یو ډکولو انوائس جوړوي؛ یو PayRam checkout_url راګرځوي. بیلانس د on-chain USDC/USDT تادیې د تایید سره اعتبار کیږي. یو ځل یو ناتادیه ډکول. |
order_vps | Bearer | product (د پلان slug)، os_id (int)، hostname?، ssh_key? | یو VPS امر کوي. د key-based root login لپاره یو ssh_key (عامه کیلي) ورکړئ. کله چې کافي وي له بیلانس څخه تادیه کوي، که نه یو انوائس د تادیې لپاره راګرځوي. |
pay_invoice | Bearer | invoice_id (int) | د یوه ملکیت شوي، ناتادیه انوائس لپاره تادیه پیلوي. یو PayRam checkout_url راګرځوي؛ VPS د تادیې د تایید سره اتوماتیک چمتو کیږي. |
د یوه VPS چلول
| وسیله | Auth | پارامترونه | څه کوي |
|---|---|---|---|
list_vps | Bearer | — | د حساب VPS خدمتونه فهرست کوي (id، حالت، پلان). id لاندې د service_id په توګه وکاروئ. |
get_vps_status | Bearer | service_id (int) | بشپړ تفصیل: حالت، مشخصات، ژوندی د VM حالت/اپټایم، او SSH لاسرسی (host، port، چمتو-د-پیسټ command). د یوه keyless سرور لپاره په لومړي کاله کې یوځلی root password راګرځوي. د order_vps وروسته تر active poll کړئ. |
power_vps | Bearer | service_id، action = start | stop | reboot | VPS بریښنا-کنټرول کوي. |
set_hostname | Bearer | service_id، hostname | د VPS hostname ټاکي (سم DNS لیبل؛ د راتلونکي بیا پیل/بیا جوړولو پر مهال پلي کیږي). |
get_vps_metrics | Bearer | service_id، timeframe? = hour | day | week | month | د وخت-لړۍ CPU، حافظه، شبکه، او د ديسک میټریکونه (ډیفالټ hour). |
ویجاړونکي — confirm ته اړتیا لري
دا ډیټا یا لاسرسی پاکوي. confirm باید د دقیق hostname (له get_vps_status څخه) یا د لیټرال DELETE سره برابر وي. لومړی له انسان سره تایید کړئ.
| وسیله | Auth | پارامترونه | څه کوي |
|---|---|---|---|
reset_password | Bearer | service_id، confirm | root پټنوم بدلوي. زوړ پټنوم سمدلاسه کار درولوي. نوی پټنوم یو ځل د get_vps_status له لارې لوستل کیږي (بریښنالیک هم کیږي). |
reinstall_vps | Bearer | service_id، os_id (int)، confirm | د ورکړل شوي OS تصویر سره پاکوي او بیا نصبوي — ټول ډیټا له لاسه ورکول کیږي. چمتو کول async دي؛ get_vps_status poll کړئ. |
cancel_service | Bearer | service_id، type? = end_of_period | immediate، confirm? | ډیفالټ end_of_period: تر هغه فعال پاتې کیږي چې تادیه شوې دوره پای ته ورسیږي، بیا نه تمدیدیږي — د ډیټا هیڅ ورکیدل نشته. immediate VM او ټول ډیټا اوس ویجاړوي (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" })
د اجنټانو لپاره یادونې
Authorization: Bearer <token>د هرې غیر-عامه کاله پر سر واستوئ.- په USDC/USDT (Base، Ethereum، Tron) تادیه وکړئ — کارت ته اړتیا نشته. یو مخکې-تادیه شوی بیلانس غوره کړئ نو امر یوه کاله وي.
- تل
get_vps_statusوکاروئ ترڅو د لاسرسي جزئیات ولولئ؛reinstall_vps،reset_password، او سمدلاسهcancel_serviceد بیرته-ناکیدونکو په توګه ونیسئ.
د تنظیم ته نوی یاست؟ د نښلولو لارښود سره پیل وکړئ، یا د اصلي REST API لپاره Docs ولولئ.
تبصرې
لا تبصرې نشته. لومړی اوسئ.