EQVPS MCP سرور 16 tools فراہم کرتا ہے جو ایک AI agent کو پلانز دریافت، ایک اکاؤنٹ کھولنے، کرپٹو سے ادا کرنے، اور ایک VPS پوری طرح چلانے دیتے ہیں۔ Endpoint: https://mcp.eqvps.com/mcp (Streamable HTTP)۔ اسے اپنے client میں جوڑنے کو connect گائیڈ دیکھیں۔
Auth ماڈل: list_plans، register_account، اور login public ہیں۔ باقی ہر tool کو ایک Bearer token درکار ہے — register_account سے فوراً ایک حاصل کریں اور اسے Authorization: Bearer <token> کے طور پر بھیجیں۔
Discovery اور auth
| Tool | Auth | پیرامیٹرز | یہ کیا کرتا ہے |
|---|---|---|---|
list_plans | public | — | تمام VPS پلانز فہرست: قیمت، specs، اور ہر پلان جو OS images بوٹ کر سکتا ہے۔ ایک product slug اور os_id چننے کو پہلے یہ کال کریں۔ |
register_account | public | first_name، last_name، email | کوئی پاس ورڈ اور انسانی قدم کے بغیر ایک اکاؤنٹ بنائیں۔ ایک Bearer token واپس دیتا ہے۔ |
login | public | email، password | ای میل + password سے log in؛ ایک Bearer token واپس دیتا ہے۔ |
whoami | Bearer | — | authenticated اکاؤنٹ پروفائل (id، نام، ای میل) واپس دیتا ہے۔ token کی توثیق کرتا ہے۔ |
Balance اور آرڈر
| Tool | Auth | پیرامیٹرز | یہ کیا کرتا ہے |
|---|---|---|---|
get_balance | Bearer | — | prepaid credit بیلنس اور کرنسی واپس دیتا ہے۔ order_vps خودبخود اس سے خرچ کرتا ہے۔ |
topup_balance | Bearer | amount (USD، مثبت) | ایک top-up invoice بنائیں؛ ایک PayRam checkout_url واپس دیتا ہے۔ on-chain USDC/USDT ادائیگی confirm ہونے پر بیلنس credit ہوتا ہے۔ ایک وقت میں ایک غیر ادا شدہ top-up۔ |
order_vps | Bearer | product (پلان slug)، os_id (int)، hostname?، ssh_key? | ایک VPS آرڈر۔ key-بنیاد root login کے لیے ایک ssh_key (public key) دیں۔ کافی ہونے پر بیلنس سے ادا، ورنہ ادا کرنے کو ایک invoice واپس دیتا ہے۔ |
pay_invoice | Bearer | invoice_id (int) | ایک مالکانہ، غیر ادا شدہ invoice کی ادائیگی شروع کریں۔ ایک PayRam checkout_url واپس دیتا ہے؛ ادائیگی confirm ہونے پر VPS خودبخود تیار ہوتا ہے۔ |
ایک VPS چلانا
| Tool | Auth | پیرامیٹرز | یہ کیا کرتا ہے |
|---|---|---|---|
list_vps | Bearer | — | اکاؤنٹ کی VPS سروسز فہرست (id، status، پلان)۔ نیچے id کو service_id کے طور پر استعمال کریں۔ |
get_vps_status | Bearer | service_id (int) | مکمل تفصیل: status، specs، live VM state/uptime، اور SSH رسائی (host، port، ready-to-paste 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 label؛ اگلے reboot/rebuild پر لاگو)۔ |
get_vps_metrics | Bearer | service_id، timeframe? = hour | day | week | month | سیریز-وقت CPU، memory، network، اور disk metrics (ڈیفالٹ hour)۔ |
ڈسٹرکٹو — confirm درکار
یہ ڈیٹا یا رسائی مٹاتے ہیں۔ confirm بالکل hostname (get_vps_status سے) یا literal DELETE کے برابر ہونا چاہیے۔ پہلے انسان سے تصدیق کریں۔
| Tool | Auth | پیرامیٹرز | یہ کیا کرتا ہے |
|---|---|---|---|
reset_password | Bearer | service_id، confirm | root پاس ورڈ گھماتا ہے۔ پرانا پاس ورڈ فوراً کام کرنا بند کر دیتا ہے۔ نیا پاس ورڈ get_vps_status کے ذریعے ایک بار پڑھا جاتا ہے (ای میل بھی)۔ |
reinstall_vps | Bearer | service_id، os_id (int)، confirm | دیے گئے OS image سے مٹا کر دوبارہ انسٹال — تمام ڈیٹا کھو جاتا ہے۔ Provisioning 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() // product "nano" چنیں، ایک os_id نوٹ کریں
register_account({ first_name, last_name, email }) // → Bearer token
topup_balance({ amount: 10 }) // واپس ملا checkout_url USDC/USDT میں ادا کریں
order_vps({ product: "nano", os_id: <list_plans سے os_id>, ssh_key: "ssh-ed25519 AAAA..." })
get_vps_status({ service_id: <your-service-id> }) // poll → active، SSH host/port/command پڑھیں
power_vps({ service_id: <your-service-id>, action: "reboot" })
agents کے لیے نوٹ
- ہر non-public کال پر
Authorization: Bearer <token>بھیجیں۔ - USDC/USDT میں ادا کریں (Base، Ethereum، Tron) — کوئی کارڈ درکار نہیں۔ ایک prepaid بیلنس کو ترجیح دیں تاکہ آرڈر ایک کال ہو۔
- رسائی تفصیلات پڑھنے کو ہمیشہ
get_vps_status؛reinstall_vps،reset_password، اور immediatecancel_serviceکو ناقابلِ واپسی سمجھیں۔
سیٹ اپ میں نئے؟ connect گائیڈ سے شروع کریں، یا اندرونی REST API کے لیے Docs پڑھیں۔
تبصرے
ابھی کوئی تبصرہ نہیں۔ پہلے بنیں۔