EQVPS
PanelEmpezar

Herramientas MCP de EQVPS para un VPS: parámetros y ejemplos de llamadas

10 jun 2026 · 6 min de lectura · EQVPS

El servidor MCP de EQVPS (versión 1.9.1) tiene 47 herramientas para un token de cliente. Esta página cubre las 23 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-20 en el servidor MCP 1.9.1 (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, get_order_limits, 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

HerramientaAutenticaciónParámetrosQué hace
list_planspublic—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_accountpublicfirst_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.
loginpublicemail, password, token_ttl_days?Devuelve un token nuevo. Solo funciona después de set_password.
refresh_tokenBearerexpires_in_days? (1–1825)Emite un token nuevo y revoca el actual al instante. Un token caducado no se puede renovar.
set_passwordBearerpassword (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.
whoamiBearer—id, nombre y email de la cuenta. Sirve para comprobar el token.

Saldo y pedido

HerramientaAutenticaciónParámetrosQué hace
get_balanceBearer—Saldo prepago y moneda. order_vps paga con él.
topup_balanceBeareramount (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_vpsBearerproduct, os_id, hostname?, ssh_key?, period? (month | year), plan_id?, location? (de | fi), quantity? (1–50), addons? (backups | extra_ipv4), idempotency_key?Pide un VPS y lo paga con el saldo si alcanza; si no, devuelve una factura. Sin location, elegimos nosotros. Los planes Windows ignoran ssh_key. Con quantity de 2 a 50 recibes una factura y ese número de servidores independientes; envía el mismo idempotency_key al reintentar.
get_order_limitspublicproduct, period?, plan_id?, location?, addons?El máximo por pedido (max_quantity = 50, protección contra errores de tecleo) y qué extras hay disponibles, con precios.
pay_invoiceBearerinvoice_idDevuelve una checkout_url para una factura pendiente. El VPS se crea al pagarla.

Gestionar un VPS

HerramientaAutenticaciónParámetrosQué hace
list_vpsBearer—Servicios activos, en creación y suspendidos. Los eliminados no aparecen.
get_vps_statusBearerservice_idEstado, especificaciones, estado en vivo y acceso: host, puerto y un command listo (SSH para Linux, RDP para Windows). reveal_password devuelve la contraseña root de un solo uso tras el arranque; password_pending: true significa: vuelve a llamar en 30–60 s.
reveal_passwordBearerservice_idContraseña root de un VPS sin clave SSH, se muestra una sola vez. Mientras el servidor arranca: password_pending: true, vuelve a llamar en 30–60 s.
power_vpsBearerservice_id, action (start | stop | reboot)Control de encendido.
set_hostnameBearerservice_id, hostnameSe 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_metricsBearerservice_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

HerramientaAutenticaciónParámetrosQué hace
get_upgrade_optionsBearerservice_idPlanes a los que este VPS puede pasar conservando sus datos: un plan mayor, NAT a IPv4 dedicada o dedicada a NAT. Cada opción muestra prorated_topup, mode y capacity_now. Un disco no se puede reducir.
change_planBearerservice_id, target_plan (product_id), confirm: trueCambia el plan en el sitio con un reinicio de un minuto aproximadamente. La diferencia prorrateada se cobra del saldo (402 si no alcanza).
cancel_serviceBearerservice_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; la respuesta incluye el campo refund_amount.
undo_cancelBearerservice_idQuita 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.

HerramientaAutenticaciónParámetrosQué hace
reset_passwordBearerservice_id, confirmUna 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 reveal_password. Para una contraseña perdida, no para un servidor que aún arranca.
reinstall_vpsBearerservice_id, os_id, confirmBorra 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_status en 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 a reset_password porque SSH no respondió al momento.
  • topup_balance y pay_invoice devuelven 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.

Preguntas frecuentes

¿Cómo llamo a estas herramientas?

Conecta un cliente MCP a https://mcp.eqvps.com/mcp (Streamable HTTP) y llama a una herramienta por su nombre con los parámetros de las tablas. La configuración de Claude Desktop, Cursor y otros clientes está en la guía de conexión.

¿Qué herramientas funcionan sin token?

list_plans, register_account y login. Todas las demás herramientas de esta página necesitan Authorization: Bearer <token>. register_account devuelve un token válido 365 días por defecto.

¿Qué es service_id?

El código de servicio que devuelven order_vps y list_vps, por ejemplo 68J67T5. También se acepta un id numérico.

¿Cómo obtiene un agente la contraseña root?

Llama a reveal_password cuando el servidor haya arrancado. La contraseña se muestra una sola vez. Si la respuesta dice password_pending: true, el servidor aún está arrancando: vuelve a llamar en 30 a 60 segundos. Si pasaste una ssh_key al pedir, entra con la clave.

¿Qué llamadas no se pueden deshacer?

reinstall_vps y cancel_service con type immediate destruyen todos los datos, y reset_password sustituye la contraseña anterior. Necesitan confirm con el hostname exacto; reinstall y reset también aceptan DELETE. Pregunta a la persona antes de llamarlas.

Comentarios

Aún no hay comentarios. Sé el primero.

Deja un comentario

Los comentarios se moderan antes de aparecer.