سرور MCP EQVPS (نسخهٔ 1.9.1) برای توکن مشتری ۴۷ ابزار دارد. این صفحه به ۲۳ ابزاری می‌پردازد که VPS را اجاره و مدیریت میکنند: هر پارامتر، نوع و مقدار پیش‌فرضش، و در پایان یک دنبالهٔ فراخوانی که می‌توانید کپی کنید. Endpoint: https://mcp.eqvps.com/mcp (Streamable HTTP). بار اول است؟ از راهنمای اتصال شروع کنید.
آخرین بررسی در 2026-10-20 روی سرور MCP 1.9.1 (tools/list).
به کدام صفحه نیاز دارید؟ پارامترهای فراخوانی‌های VPS در همین صفحه است. همهٔ ابزارها در یک فهرست، از جمله واگذاری دسترسی، پشتیبانی، سندباکس‌ها و ۳۰ ابزار نمایندگان فروش، در فهرست کامل آمده است. اینکه یک توکن نشت‌کرده چه می‌تواند بکند و چطور عامل را محدود کنید، در 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 عددی هم کار میکند.
حساب و توکن
| ابزار | احراز هویت | پارامترها | کاربرد |
|---|---|---|---|
list_plans | public | — | پلن‌ها با قیمت، مشخصات و ایمیج‌های سیستم‌عاملی که هر کدام بالا می‌آورد. plans[] شامل plan_id ماهانه و سالانه است. اول این را فراخوانی کنید. |
register_account | public | first_name, last_name, email, token_ttl_days? (1–1825, پیشفرض 365) | یک حساب بدون رمز می‌سازد و یک token از نوع Bearer قابل استفادهٔ مجدد را همراه token_expires_at برمیگرداند. فقط یک بار فراخوانی کنید: فراخوانی دوم یک حساب خالی دیگر می‌سازد. |
login | public | email, password, token_ttl_days? | توکن تازه برمیگرداند. فقط پس از set_password کار میکند. |
refresh_token | Bearer | expires_in_days? (1–1825) | توکن تازه صادر میکند و توکن فعلی را فوراً باطل میکند. توکن منقضی را نمی‌توان تمدید کرد. |
set_password | Bearer | password (دست‌کم ۸ نویسه، حرف و رقم) | ورود با ایمیل و رمز از طریق login را به‌عنوان پشتیبان در صورت گم شدن توکن فعال میکند. فقط یک بار؛ فراخوانی دوم 409 برمیگرداند. |
whoami | Bearer | — | id، نام و ایمیل حساب. برای بررسی توکن به کار می‌آید. |
موجودی و سفارش
| ابزار | احراز هویت | پارامترها | کاربرد |
|---|---|---|---|
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 ما انتخاب می‌کنیم. پلن‌های Windows ssh_key را نادیده می‌گیرند. با quantity بین ۲ تا ۵۰ یک صورتحساب و همان تعداد سرور جدا می‌گیرید؛ هنگام تلاش دوباره همان idempotency_key را بفرستید. |
get_order_limits | public | product, period?, plan_id?, location?, addons? | سقف هر سفارش (max_quantity = 50، محافظ در برابر اشتباه تایپی) و خدمات جانبی موجود، با قیمت. |
pay_invoice | Bearer | invoice_id | برای فاکتور پرداخت‌نشده checkout_url برمیگرداند. VPS پس از پرداخت ساخته میشود. |
مدیریت VPS
| ابزار | احراز هویت | پارامترها | کاربرد |
|---|---|---|---|
list_vps | Bearer | — | سرویس‌های فعال، در حال ساخت و معلق. سرویس‌های حذف‌شده نمایش داده نمی‌شوند. |
get_vps_status | Bearer | service_id | وضعیت، مشخصات، حالت زنده و اطلاعات دسترسی: میزبان، پورت و command آماده (SSH برای Linux، RDP برای Windows). reveal_password پس از بالا آمدن، رمز root یک‌بارمصرف را برمیگرداند؛ password_pending: true یعنی ۳۰ تا ۶۰ ثانیه بعد دوباره فراخوانی کنید. |
reveal_password | Bearer | service_id | رمز root سرور VPS بدون کلید SSH، فقط یک بار نشان داده میشود. تا سرور بالا بیاید: password_pending: true؛ پس از ۳۰ تا ۶۰ ثانیه دوباره فراخوانی کنید. |
power_vps | Bearer | service_id, action (start | stop | reboot) | کنترل روشن و خاموش. |
set_hostname | Bearer | service_id, hostname | از طریق guest agent داخل سرور در حال اجرا اعمال میشود. در Windows پس از راه‌اندازی دوباره اثر میکند (reboot_required: true). اگر سرور خاموش باشد 409 agent_unavailable برمیگرداند. |
get_vps_metrics | Bearer | service_id, timeframe? (hour | day | week | month, پیشفرض hour) | پردازنده، حافظه، شبکه و دیسک در طول زمان. |
تغییر پلن و لغو
| ابزار | احراز هویت | پارامترها | کاربرد |
|---|---|---|---|
get_upgrade_options | Bearer | service_id | پلن‌هایی که این VPS می‌تواند با حفظ دادهها به آن‌ها برود: پلن بزرگ‌تر، از NAT به IPv4 اختصاصی یا از اختصاصی به NAT. هر گزینه prorated_topup، mode و capacity_now را نشان می‌دهد. دیسک کوچک نمی‌شود. |
change_plan | Bearer | service_id, target_plan (product_id), confirm: true | پلن را در جا با یک ری‌استارت حدوداً یک‌دقیقه‌ای عوض میکند. مابه‌التفاوت متناسب از موجودی کم میشود (اگر کافی نباشد 402). |
cancel_service | Bearer | service_id, reason (۳ تا ۵۰۰ نویسه، الزامی), type? (end_of_period | immediate), confirm? | پیشفرض end_of_period: سرور تا پایان دورهٔ پرداخت‌شده کار میکند و تمدید نمی‌شود. immediate سرور را فوراً از بین می‌برد، confirm با hostname دقیق می‌خواهد؛ پاسخ شامل فیلد refund_amount است. |
undo_cancel | Bearer | service_id | لغو زمان‌بندی‌شدهٔ end_of_period را برمی‌دارد. لغو فوری برگشتپذیر نیست. |
مخرب: این‌ها confirm میخواهند
confirm همان hostname دقیق از get_vps_status یا DELETE است. پیش از فراخوانی از انسان بپرسید.
| ابزار | احراز هویت | پارامترها | کاربرد |
|---|---|---|---|
reset_password | Bearer | service_id, confirm | رمز root تازه در ۱۰ تا ۳۰ ثانیه به سرور در حال اجرا می‌رسد و رمز قبلی دیگر کار نمی‌کند. رمز تازه را یک بار با reveal_password بخوانید. برای رمز گم‌شده است، نه برای سروری که هنوز بالا می‌آید. |
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 آمده است.
نظرات
هنوز نظری نیست. اولین نفر باشید.