MCP сървърът на EQVPS (версия 1.9.1) има 47 инструмента за клиентски токен. Тази страница описва 23 от тях, които наемат VPS и го управляват: всеки параметър, неговия тип и стойност по подразбиране, а накрая поредица от извиквания за копиране. Endpoint: https://mcp.eqvps.com/mcp (Streamable HTTP). За първи път? Започни с ръководството за свързване.
Последна проверка на 2026-10-20 на MCP сървър 1.9.1 (tools/list).
Коя страница ти трябва? Параметрите за VPS извикванията са на тази страница. Всички инструменти в един списък, включително делегиране, поддръжка, sandbox-и и 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 | — | Планове с цени, характеристики и образите на ОС, които всеки стартира. plans[] съдържа месечния и годишния plan_id. Извиквай го първо. |
register_account | public | first_name, last_name, email, token_ttl_days? (1–1825, по подразбиране 365) | Създава акаунт без парола и връща многократно използваем Bearer token с token_expires_at. Извикай го веднъж: второ извикване създава втори, празен акаунт. |
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 избираме ние. 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 | Статус, характеристики, текущо състояние и достъп: хост, порт и готова command (SSH за Linux, RDP за Windows). reveal_password връща еднократната root парола след стартиране; password_pending: true значи: извикай отново след 30–60 с. |
reveal_password | Bearer | service_id | Root паролата на VPS без SSH ключ, показва се веднъж. Докато сървърът стартира: password_pending: true, извикай отново след 30–60 s. |
power_vps | Bearer | service_id, action (start | stop | reboot) | Управление на захранването. |
set_hostname | Bearer | service_id, hostname | Прилага се в работещия сървър през guest агента. В 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. Дискът не може да се намалява. |
change_plan | Bearer | service_id, target_plan (product_id), confirm: true | Сменя плана на място с едно рестартиране от около минута. Пропорционалната разлика се взема от баланса (402, ако не стига). |
cancel_service | Bearer | service_id, reason (3–500 знака, задължително), 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. Попитай човека, преди да извикаш.
| Tool | Auth | Parameters | What it does |
|---|---|---|---|
reset_password | Bearer | service_id, confirm | Нова root парола достига работещия сървър за 10–30 с, а старата спира да работи. Прочети новата веднъж с 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 запиши токена във файл: променлива на shell не оцелява между отделни команди. - Чети данните за достъп от
get_vps_status, вместо да гадаеш порта. NAT плановете използват личен порт; плановете със собствен IPv4 използват 22 за Linux и 3389 за Windows. - Нов сървър стартира за около минута. Продължавай да проверяваш
get_vps_status; не извиквайreset_passwordсамо защото SSH не отговори веднага. topup_balanceиpay_invoiceвръщат линк за плащане, който трябва да плати човек или портфейл. Monero е отделно ръчно зареждане в таблото: виж плащане с Monero.
Същите действия без MCP са описани в документацията на REST API.
Коментари
Още няма коментари. Бъди първият.