EQVPS MCP سرور (ورژن 1.7.0) میں کسٹمر ٹوکن کے لیے 46 ٹولز ہیں۔ یہ پیج ان میں سے ان 22 ٹولز کا احاطہ کرتا ہے جو VPS کرائے پر لیتے اور چلاتے ہیں: ہر پیرامیٹر، اس کی ٹائپ اور ڈیفالٹ ویلیو، اور آخر میں کالز کی ایک ترتیب جسے آپ کاپی کر سکتے ہیں۔ Endpoint: https://mcp.eqvps.com/mcp (Streamable HTTP)۔ پہلی بار؟ کنکشن گائیڈ سے شروع کریں۔
آخری جانچ 2026-10-18 کو MCP سرور 1.7.0 پر (tools/list)۔
آپ کو کون سا پیج چاہیے؟ VPS کالز کے پیرامیٹرز اسی پیج پر ہیں۔ ڈیلیگیشن، سپورٹ، سینڈ باکس اور 30 ری سیلر ٹولز سمیت تمام ٹولز ایک فہرست میں مکمل فہرست میں ہیں۔ لیک ہونے والا ٹوکن کیا کر سکتا ہے اور ایجنٹ کو کیسے محدود کریں، یہ MCP guardrails میں ہے۔
تصدیق۔ list_plans، get_order_limits، register_account اور login عوامی ہیں۔ باقی سب کو Authorization: Bearer <token> چاہیے۔ ایک ہی MCP سیشن میں register_account یا login کے بعد ٹوکن یاد رکھا جاتا ہے۔
service_id وہ سروس کوڈ ہے جو order_vps یا list_vps سے ملتا ہے، جیسے 68J67T5۔ عددی id بھی چلتا ہے۔
اکاؤنٹ اور ٹوکن
| Tool | Auth | Parameters | What it does |
|---|---|---|---|
list_plans | public | — | قیمت، تفصیلات اور ہر پلان پر بوٹ ہونے والی OS امیجز کے ساتھ پلانز۔ plans[] میں ماہانہ اور سالانہ plan_id ہوتا ہے۔ سب سے پہلے کال کریں۔ |
register_account | public | first_name, last_name, email, token_ttl_days? (1–1825, ڈیفالٹ 365) | بغیر پاس ورڈ کا اکاؤنٹ بناتا ہے اور token_expires_at کے ساتھ دوبارہ استعمال ہونے والا Bearer token واپس کرتا ہے۔ ایک ہی بار کال کریں: دوسری کال ایک اور خالی اکاؤنٹ بنا دیتی ہے۔ |
login | public | email, password, token_ttl_days? | نیا ٹوکن واپس کرتا ہے۔ صرف set_password کے بعد کام کرتا ہے۔ |
refresh_token | Bearer | expires_in_days? (1–1825) | نیا ٹوکن جاری کرتا ہے اور موجودہ ٹوکن فوراً منسوخ کرتا ہے۔ ختم شدہ ٹوکن ریفریش نہیں ہوتا۔ |
set_password | Bearer | password (کم از کم 8 حروف، حروف اور اعداد) | ٹوکن کھو جانے کی صورت کے لیے ای میل اور پاس ورڈ سے login چالو کرتا ہے۔ ایک ہی بار؛ دوسری کال 409 دیتی ہے۔ |
whoami | Bearer | — | اکاؤنٹ کا id، نام اور ای میل۔ ٹوکن جانچنے کے لیے۔ |
بیلنس اور آرڈر
| Tool | Auth | Parameters | What it does |
|---|---|---|---|
get_balance | Bearer | — | پری پیڈ بیلنس اور کرنسی۔ order_vps اسی سے ادائیگی کرتا ہے۔ |
topup_balance | Bearer | amount (USD) | کرپٹو ٹاپ اپ بناتا ہے اور checkout_url واپس کرتا ہے۔ ادائیگی آن چین تصدیق ہوتے ہی بیلنس میں آ جاتی ہے۔ ایک وقت میں صرف ایک غیر ادا شدہ ٹاپ اپ۔ |
order_vps | Bearer | product, os_id, hostname?, ssh_key?, period? (month | year), plan_id?, location? (de | fi), quantity? (1–50), addons? (backups | extra_ipv4), idempotency_key? | VPS آرڈر کرتا ہے اور بیلنس کافی ہو تو اسی سے ادائیگی کرتا ہے؛ ورنہ انوائس لوٹاتا ہے۔ location نہ ہو تو ہم چنتے ہیں۔ گنجائش کی وجہ سے آرڈر کبھی رد نہیں ہوتا: اگر لوکیشن میں ابھی جگہ یا خالی IPv4 نہیں، تو ادائیگی شدہ سرور وہیں بننے کی قطار میں انتظار کرتا ہے (get_vps_status میں queued: true) اور عموماً 24 گھنٹوں میں تیار ہو جاتا ہے۔ Windows پلان ssh_key کو نظرانداز کرتے ہیں۔ quantity 2–50 پر ایک انوائس اور اتنے ہی الگ سرور ملتے ہیں؛ دوبارہ کوشش میں وہی idempotency_key بھیجیں۔ |
get_order_limits | public | product, period?, plan_id?, location?, addons? | ایک آرڈر کی زیادہ سے زیادہ حد (max_quantity = 50، ٹائپنگ کی غلطی سے تحفظ) اور کون سی اضافی خدمات دستیاب ہیں، قیمتوں کے ساتھ۔ |
pay_invoice | Bearer | invoice_id | غیر ادا شدہ انوائس کے لیے checkout_url واپس کرتا ہے۔ ادائیگی کے بعد VPS بنتا ہے۔ |
VPS چلانا
| Tool | Auth | Parameters | What it does |
|---|---|---|---|
list_vps | Bearer | — | فعال، زیرِ تخلیق اور معطل سروسز۔ حذف شدہ سروسز نظر نہیں آتیں۔ |
get_vps_status | Bearer | service_id, reveal? | اسٹیٹس، تفصیلات، لائیو حالت اور رسائی: ہوسٹ، پورٹ اور تیار command (Linux کے لیے SSH، Windows کے لیے RDP)۔ reveal: true بوٹ کے بعد ایک بار کا root پاس ورڈ دیتا ہے؛ password_pending: true کا مطلب ہے 30–60 سیکنڈ بعد دوبارہ کال کریں۔ |
power_vps | Bearer | service_id, action (start | stop | reboot) | پاور کنٹرول۔ |
set_hostname | Bearer | service_id, hostname | چلتے سرور کے اندر گیسٹ ایجنٹ کے ذریعے لاگو ہوتا ہے۔ Windows پر ری بوٹ کے بعد اثر کرتا ہے (reboot_required: true)۔ سرور بند ہو تو 409 agent_unavailable آتا ہے۔ |
get_vps_metrics | Bearer | service_id, timeframe? (hour | day | week | month, ڈیفالٹ hour) | وقت کے ساتھ CPU، میموری، نیٹ ورک اور ڈسک۔ |
پلان کی تبدیلی اور منسوخی
| Tool | Auth | Parameters | What it does |
|---|---|---|---|
get_upgrade_options | Bearer | service_id | وہ پلان جن پر یہ VPS ڈیٹا برقرار رکھتے ہوئے جا سکتا ہے: بڑا پلان، NAT سے dedicated IPv4 یا dedicated سے NAT۔ ہر آپشن میں prorated_topup، mode اور capacity_now نظر آتا ہے (false = ادائیگی کے بعد قطار سے لاگو ہوگا، عموماً 24 گھنٹوں میں)۔ ڈسک چھوٹی نہیں کی جا سکتی۔ |
change_plan | Bearer | service_id, target_plan (product_id), confirm: true | پلان کو وہیں بدلتا ہے، تقریباً ایک منٹ کے ایک ری بوٹ کے ساتھ۔ متناسب فرق بیلنس سے کٹتا ہے (کم ہو تو 402)۔ اگر ہوسٹ پر ابھی جگہ نہیں: 202 queued — ادائیگی ہو گئی اور خودکار طور پر لاگو ہوگا، عموماً 24 گھنٹوں میں۔ |
cancel_service | Bearer | service_id, reason (3–500 حروف، لازمی), type? (end_of_period | immediate), confirm? | ڈیفالٹ end_of_period: سرور ادا شدہ مدت کے آخر تک چلتا ہے اور تجدید نہیں ہوتی۔ immediate سرور کو فوراً ختم کرتا ہے، درست hostname والا confirm مانگتا ہے؛ جواب میں refund_amount فیلڈ ہوتی ہے۔ |
undo_cancel | Bearer | service_id | طے شدہ end_of_period منسوخی ہٹاتا ہے۔ فوری منسوخی واپس نہیں ہوتی۔ |
تباہ کن: انہیں confirm چاہیے
confirm میں get_vps_status سے ملا درست hostname یا DELETE دیں۔ کال کرنے سے پہلے انسان سے پوچھیں۔
| Tool | Auth | Parameters | What it does |
|---|---|---|---|
reset_password | Bearer | service_id, confirm | نیا root پاس ورڈ 10–30 سیکنڈ میں چلتے سرور تک پہنچتا ہے اور پرانا کام کرنا بند کر دیتا ہے۔ نیا پاس ورڈ get_vps_status (reveal: true) سے ایک بار پڑھیں۔ کھوئے ہوئے پاس ورڈ کے لیے ہے، ابھی بوٹ ہوتے سرور کے لیے نہیں۔ |
reinstall_vps | Bearer | service_id, os_id, confirm | ڈسک مٹا کر os_id انسٹال کرتا ہے۔ سارا ڈیٹا ضائع ہو جاتا ہے۔ پس منظر میں چلتا ہے؛ get_vps_status دیکھتے رہیں۔ |
مثال: صفر سے چلتے سرور تک
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
ایجنٹس کے لیے نوٹس
- تین عوامی کالز کے سوا ہر کال میں
Authorization: Bearer <token>بھیجیں۔ سادہ HTTP میں ٹوکن فائل میں محفوظ کریں: شیل ویری ایبل الگ الگ کمانڈز کے درمیان نہیں بچتا۔ - پورٹ کا اندازہ لگانے کے بجائے رسائی کی معلومات
get_vps_statusسے پڑھیں۔ NAT پلانز ذاتی پورٹ استعمال کرتے ہیں؛ ڈیڈیکیٹڈ IPv4 پلانز Linux کے لیے 22 اور Windows کے لیے 3389۔ - نئے سرور کو بوٹ ہونے میں تقریباً ایک منٹ لگتا ہے۔
get_vps_statusدیکھتے رہیں؛ SSH نے فوراً جواب نہیں دیا توreset_passwordکال نہ کریں۔ topup_balanceاورpay_invoiceادائیگی کا لنک واپس کرتے ہیں، جسے کسی انسان یا والیٹ کو ادا کرنا ہوتا ہے۔ مونیرو ڈیش بورڈ میں الگ دستی ٹاپ اپ ہے: دیکھیں مونیرو سے ادائیگی۔
MCP کے بغیر یہی کام REST API دستاویزات میں ہیں۔
تبصرے
ابھی کوئی تبصرہ نہیں۔ پہلے بنیں۔