Máy chủ MCP của EQVPS (phiên bản 1.9.1) có 47 công cụ cho token khách hàng. Trang này nói về 23 công cụ dùng để thuê và vận hành VPS: từng tham số, kiểu và giá trị mặc định, và cuối trang là một chuỗi lệnh gọi bạn có thể sao chép. Endpoint: https://mcp.eqvps.com/mcp (Streamable HTTP). Lần đầu dùng? Hãy bắt đầu với hướng dẫn kết nối.
Kiểm tra lần cuối ngày 2026-10-20 trên máy chủ MCP 1.9.1 (tools/list).
Bạn cần trang nào? Tham số cho các lệnh gọi VPS nằm ở trang này. Mọi công cụ trong một danh sách, gồm ủy quyền, hỗ trợ, sandbox và 30 công cụ cho đại lý, có trong danh sách đầy đủ. Token bị lộ có thể làm gì và cách giới hạn agent có trong MCP guardrails.
Xác thực. list_plans, get_order_limits, register_account và login là công khai. Mọi thứ khác cần Authorization: Bearer <token>. Trong cùng một phiên MCP, token được ghi nhớ sau register_account hoặc login.
service_id là mã dịch vụ từ order_vps hoặc list_vps, ví dụ 68J67T5. id dạng số cũng dùng được.
Tài khoản và token
| Tool | Auth | Parameters | What it does |
|---|---|---|---|
list_plans | public | — | Các gói kèm giá, cấu hình và image hệ điều hành mỗi gói khởi động được. plans[] chứa plan_id theo tháng và theo năm. Gọi đầu tiên. |
register_account | public | first_name, last_name, email, token_ttl_days? (1–1825, mặc định 365) | Tạo tài khoản không mật khẩu và trả về một token Bearer dùng lại được cùng token_expires_at. Chỉ gọi một lần: lần gọi thứ hai tạo ra tài khoản thứ hai, trống. |
login | public | email, password, token_ttl_days? | Trả về token mới. Chỉ hoạt động sau set_password. |
refresh_token | Bearer | expires_in_days? (1–1825) | Cấp token mới và thu hồi token hiện tại ngay lập tức. Token đã hết hạn thì không làm mới được. |
set_password | Bearer | password (từ 8 ký tự, có chữ và số) | Bật login bằng email và mật khẩu làm phương án dự phòng khi mất token. Chỉ một lần; lần gọi thứ hai trả về 409. |
whoami | Bearer | — | id, tên và email của tài khoản. Dùng để kiểm tra token. |
Số dư và đặt hàng
| Tool | Auth | Parameters | What it does |
|---|---|---|---|
get_balance | Bearer | — | Số dư trả trước và tiền tệ. order_vps trừ tiền từ đây. |
topup_balance | Bearer | amount (USD) | Tạo một lần nạp bằng crypto và trả về checkout_url. Số dư được cộng khi thanh toán được xác nhận on-chain. Mỗi lúc chỉ có một lần nạp chưa thanh toán. |
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? | Đặt một VPS và thanh toán từ số dư nếu đủ; nếu không sẽ trả về hóa đơn. Không có location thì chúng tôi tự chọn. Gói Windows bỏ qua ssh_key. Với quantity 2–50 bạn nhận một hóa đơn và số máy chủ riêng tương ứng; gửi cùng idempotency_key khi thử lại. |
get_order_limits | public | product, period?, plan_id?, location?, addons? | Mức tối đa mỗi đơn (max_quantity = 50, chống gõ nhầm) và các dịch vụ bổ sung có sẵn, kèm giá. |
pay_invoice | Bearer | invoice_id | Trả về checkout_url cho hóa đơn chưa thanh toán. VPS được tạo khi đã thanh toán. |
Vận hành VPS
| Tool | Auth | Parameters | What it does |
|---|---|---|---|
list_vps | Bearer | — | Các dịch vụ đang hoạt động, đang tạo và bị tạm ngưng. Dịch vụ đã xóa không hiện. |
get_vps_status | Bearer | service_id | Trạng thái, cấu hình, tình trạng thực tế và truy cập: host, cổng và một command dùng ngay (SSH cho Linux, RDP cho Windows). reveal_password trả về mật khẩu root dùng một lần sau khi khởi động; password_pending: true nghĩa là gọi lại sau 30–60 giây. |
reveal_password | Bearer | service_id | Mật khẩu root của VPS không có khóa SSH, chỉ hiện một lần. Khi máy chủ còn đang khởi động: password_pending: true, gọi lại sau 30–60 giây. |
power_vps | Bearer | service_id, action (start | stop | reboot) | Điều khiển nguồn. |
set_hostname | Bearer | service_id, hostname | Áp dụng bên trong máy chủ đang chạy qua guest agent. Trên Windows có hiệu lực sau khi khởi động lại (reboot_required: true). Nếu máy chủ đang tắt, trả về 409 agent_unavailable. |
get_vps_metrics | Bearer | service_id, timeframe? (hour | day | week | month, mặc định hour) | CPU, bộ nhớ, mạng và ổ đĩa theo thời gian. |
Đổi gói và hủy
| Tool | Auth | Parameters | What it does |
|---|---|---|---|
get_upgrade_options | Bearer | service_id | Các gói VPS này có thể chuyển sang mà vẫn giữ dữ liệu: gói lớn hơn, NAT sang IPv4 riêng, hoặc IP riêng sang NAT. Mỗi lựa chọn có prorated_topup, mode và capacity_now. Không thể thu nhỏ ổ đĩa. |
change_plan | Bearer | service_id, target_plan (product_id), confirm: true | Đổi gói tại chỗ với một lần khởi động lại khoảng một phút. Phần chênh lệch theo tỷ lệ được trừ vào số dư (402 nếu không đủ). |
cancel_service | Bearer | service_id, reason (3–500 ký tự, bắt buộc), type? (end_of_period | immediate), confirm? | Mặc định end_of_period: máy chủ chạy đến hết kỳ đã trả và không gia hạn. immediate hủy máy chủ ngay, cần confirm bằng đúng hostname; phản hồi có trường refund_amount. |
undo_cancel | Bearer | service_id | Gỡ lịch hủy end_of_period đã đặt. Hủy ngay lập tức thì không hoàn tác được. |
Phá hủy: cần confirm
confirm là đúng hostname lấy từ get_vps_status, hoặc DELETE. Hãy hỏi con người trước khi gọi.
| Tool | Auth | Parameters | What it does |
|---|---|---|---|
reset_password | Bearer | service_id, confirm | Mật khẩu root mới đến máy chủ đang chạy trong 10–30 giây và mật khẩu cũ ngừng hoạt động. Đọc mật khẩu mới một lần bằng reveal_password. Dành cho mật khẩu bị mất, không phải cho máy chủ còn đang khởi động. |
reinstall_vps | Bearer | service_id, os_id, confirm | Xóa ổ đĩa và cài os_id. Mất toàn bộ dữ liệu. Chạy nền; theo dõi get_vps_status. |
Ví dụ: từ con số không đến máy chủ đang chạy
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
Ghi chú cho agent
- Gửi
Authorization: Bearer <token>trong mọi lệnh gọi trừ ba lệnh công khai. Với HTTP thông thường, hãy lưu token vào file: biến shell không tồn tại qua các lệnh riêng rẽ. - Đọc thông tin truy cập từ
get_vps_statusthay vì đoán cổng. Gói NAT dùng cổng riêng; gói có IPv4 riêng dùng 22 cho Linux và 3389 cho Windows. - Máy chủ mới cần khoảng một phút để khởi động. Tiếp tục theo dõi
get_vps_status; đừng gọireset_passwordchỉ vì SSH chưa trả lời ngay. topup_balancevàpay_invoicetrả về một liên kết thanh toán mà con người hoặc ví phải trả. Monero là một lần nạp thủ công riêng trong bảng điều khiển: xem thanh toán bằng Monero.
Các thao tác tương tự không qua MCP có trong tài liệu REST API.
Bình luận
Chưa có bình luận nào. Hãy là người đầu tiên.