El servidor MCP de EQVPS (versión 1.6.0) tiene 45 herramientas para un token de cliente. Esta página cubre las 21 que alquilan y gestionan un VPS: cada parámetro, su tipo y valor por defecto, y al final una secuencia de llamadas para copiar. Endpoint: https://mcp.eqvps.com/mcp (Streamable HTTP). ¿Es tu primera vez? Empieza por la guía de conexión.
Última verificación el 2026-10-04 en el servidor MCP 1.6.0 (tools/list).
¿Qué página necesitas? Los parámetros de las llamadas para VPS están en esta página. Todas las herramientas en una lista, incluidas delegación, soporte, sandboxes y las 30 de revendedor, están en la lista completa. Qué puede hacer un token filtrado y cómo limitar a un agente, en MCP guardrails.
Autenticación. list_plans, register_account y login son públicas. Todo lo demás necesita Authorization: Bearer <token>. Dentro de una misma sesión MCP, el token se recuerda tras register_account o login.
service_id es el código de servicio de order_vps o list_vps, por ejemplo 68J67T5. Un id numérico también sirve.
Cuenta y token
| Tool | Auth | Parameters | What it does |
|---|---|---|---|
list_plans | public | — | Planes con precios, especificaciones y las imágenes de SO que arranca cada uno. plans[] incluye el plan_id mensual y anual. Llámala primero. |
register_account | public | first_name, last_name, email, token_ttl_days? (1–1825, por defecto 365) | Crea una cuenta sin contraseña y devuelve un token Bearer reutilizable con token_expires_at. Llámala una vez: una segunda llamada crea una segunda cuenta vacía. |
login | public | email, password, token_ttl_days? | Devuelve un token nuevo. Solo funciona después de set_password. |
refresh_token | Bearer | expires_in_days? (1–1825) | Emite un token nuevo y revoca el actual al instante. Un token caducado no se puede renovar. |
set_password | Bearer | password (8+ caracteres, letras y números) | Activa login con email y contraseña como respaldo si pierdes el token. Funciona una vez; una segunda llamada devuelve 409. |
whoami | Bearer | — | id, nombre y email de la cuenta. Sirve para comprobar el token. |
Saldo y pedido
| Tool | Auth | Parameters | What it does |
|---|---|---|---|
get_balance | Bearer | — | Saldo prepago y moneda. order_vps paga con él. |
topup_balance | Bearer | amount (USD) | Crea una recarga en cripto y devuelve una checkout_url. El saldo se acredita cuando el pago se confirma on-chain. Solo una recarga sin pagar a la vez. |
order_vps | Bearer | product, os_id, hostname?, ssh_key?, period? (month | year), plan_id?, location? (de | fi) | Pide un VPS y lo paga con el saldo si alcanza; si no, devuelve una factura. Sin location, elegimos nosotros. Una ubicación sin capacidad libre devuelve 409 location_unavailable con una lista available, y no se cobra nada. Los planes Windows ignoran ssh_key. |
pay_invoice | Bearer | invoice_id | Devuelve una checkout_url para una factura pendiente. El VPS se crea al pagarla. |
Gestionar un VPS
| Tool | Auth | Parameters | What it does |
|---|---|---|---|
list_vps | Bearer | — | Servicios activos, en creación y suspendidos. Los eliminados no aparecen. |
get_vps_status | Bearer | service_id, reveal? | Estado, especificaciones, estado en vivo y acceso: host, puerto y un command listo (SSH para Linux, RDP para Windows). reveal: true devuelve la contraseña root de un solo uso tras el arranque; password_pending: true significa: vuelve a llamar en 30–60 s. |
power_vps | Bearer | service_id, action (start | stop | reboot) | Control de encendido. |
set_hostname | Bearer | service_id, hostname | Se aplica dentro del servidor en marcha mediante el agente invitado. En Windows surte efecto tras reiniciar (reboot_required: true). Si el servidor está apagado, devuelve 409 agent_unavailable. |
get_vps_metrics | Bearer | service_id, timeframe? (hour | day | week | month, por defecto hour) | CPU, memoria, red y disco a lo largo del tiempo. |
Cambio de plan y cancelación
| Tool | Auth | Parameters | What it does |
|---|---|---|---|
get_upgrade_options | Bearer | service_id | Planes a los que este VPS puede pasar conservando sus datos: uno más grande, de NAT a IPv4 dedicada o de dedicada a NAT. Cada opción muestra prorated_topup y mode. Un disco no puede encogerse. |
change_plan | Bearer | service_id, target_plan (product_id), confirm: true | Cambia el plan en el sitio con un reinicio de alrededor de un minuto. La diferencia prorrateada se cobra del saldo (402 si no alcanza); pasar a NAT devuelve la diferencia. |
cancel_service | Bearer | service_id, reason (3–500 caracteres, obligatorio), type? (end_of_period | immediate), confirm? | Por defecto end_of_period: el servidor funciona hasta que acaba el periodo pagado y no se renueva. immediate destruye el servidor ya, necesita confirm con el hostname exacto y devuelve el tiempo no usado al saldo (refund_amount). |
undo_cancel | Bearer | service_id | Quita una cancelación end_of_period programada. Una inmediata no se puede deshacer. |
Destructivas: necesitan confirm
confirm es el hostname exacto de get_vps_status, o DELETE. Pregunta a la persona antes de llamar.
| Tool | Auth | Parameters | What it does |
|---|---|---|---|
reset_password | Bearer | service_id, confirm | Una nueva contraseña root llega al servidor en marcha en 10–30 s y la anterior deja de funcionar. Lee la nueva una vez con get_vps_status (reveal: true). Para una contraseña perdida, no para un servidor que aún arranca. |
reinstall_vps | Bearer | service_id, os_id, confirm | Borra el disco e instala os_id. Se pierden todos los datos. Se ejecuta en segundo plano; consulta get_vps_status. |
Ejemplo: de cero a un servidor en marcha
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
Notas para agentes
- Envía
Authorization: Bearer <token>en cada llamada salvo las tres públicas. Con HTTP simple, guarda el token en un archivo: una variable de shell no sobrevive entre comandos separados. - Lee los datos de acceso en
get_vps_statusen lugar de adivinar el puerto. Los planes NAT usan un puerto personal; los planes con IPv4 dedicada usan 22 para Linux y 3389 para Windows. - Un servidor nuevo tarda alrededor de un minuto en arrancar. Sigue consultando
get_vps_status; no llames areset_passwordporque SSH no respondió al momento. topup_balanceypay_invoicedevuelven un enlace de pago, y una persona o una wallet tiene que pagarlo. Monero es una recarga manual aparte en el panel: consulta pagar con Monero.
Las mismas acciones sin MCP están en la documentación de la API REST.
Comentarios
Aún no hay comentarios. Sé el primero.