El servidor MCP de EQVPS expone 16 herramientas que permiten a un agente de IA descubrir planes, abrir una cuenta, pagar con cripto y operar un VPS por completo. Endpoint: https://mcp.eqvps.com/mcp (Streamable HTTP). Consulta la guía de conexión para conectarlo a tu cliente.
Modelo de auth: list_plans, register_account y login son públicas. Cualquier otra herramienta requiere un token Bearer — obtén uno al instante de register_account y envíalo como Authorization: Bearer <token>.
Descubrimiento y auth
| Herramienta | Auth | Parámetros | Qué hace |
|---|---|---|---|
list_plans | pública | — | Lista todos los planes VPS: precios, especificaciones y las imágenes de SO que cada plan puede arrancar. Llámala primero para elegir un slug de product y un os_id. |
register_account | pública | first_name, last_name, email | Crea una cuenta sin contraseña y sin paso humano. Devuelve un token Bearer. |
login | pública | email, password | Inicia sesión con correo + contraseña; devuelve un token Bearer. |
whoami | Bearer | — | Devuelve el perfil de la cuenta autenticada (id, nombre, correo). Verifica el token. |
Saldo y pedidos
| Herramienta | Auth | Parámetros | Qué hace |
|---|---|---|---|
get_balance | Bearer | — | Devuelve el saldo de crédito prepago y la moneda. order_vps gasta de él automáticamente. |
topup_balance | Bearer | amount (USD, positivo) | Crea una factura de recarga; devuelve una checkout_url de PayRam. El saldo se acredita una vez que el pago on-chain en USDC/USDT se confirma. Una recarga sin pagar a la vez. |
order_vps | Bearer | product (slug del plan), os_id (int), hostname?, ssh_key? | Pide un VPS. Pasa una ssh_key (clave pública) para root basado en clave. Paga del saldo cuando es suficiente, de lo contrario devuelve una factura a pagar. |
pay_invoice | Bearer | invoice_id (int) | Inicia el pago de una factura propia sin pagar. Devuelve una checkout_url de PayRam; el VPS se aprovisiona automáticamente una vez que el pago se confirma. |
Operar un VPS
| Herramienta | Auth | Parámetros | Qué hace |
|---|---|---|---|
list_vps | Bearer | — | Lista los servicios VPS de la cuenta (id, estado, plan). Usa id como service_id abajo. |
get_vps_status | Bearer | service_id (int) | Detalle completo: estado, especificaciones, estado/tiempo activo de la VM en vivo, y acceso SSH (host, puerto, command listo para pegar). En la primera llamada para un servidor sin clave devuelve la password root de un solo uso. Consulta tras order_vps hasta active. |
power_vps | Bearer | service_id, action = start | stop | reboot | Control de energía del VPS. |
set_hostname | Bearer | service_id, hostname | Fija el nombre de host del VPS (etiqueta DNS válida; se aplica en el próximo reinicio/reconstrucción). |
get_vps_metrics | Bearer | service_id, timeframe? = hour | day | week | month | Métricas de series temporales de CPU, memoria, red y disco (por defecto hour). |
Destructivas — requieren confirm
Estas borran datos o acceso. confirm debe igualar el nombre de host exacto (de get_vps_status) o el literal DELETE. Confirma primero con el humano.
| Herramienta | Auth | Parámetros | Qué hace |
|---|---|---|---|
reset_password | Bearer | service_id, confirm | Rota la contraseña root. La contraseña ANTIGUA deja de funcionar de inmediato. La nueva contraseña se lee una vez vía get_vps_status (también por correo). |
reinstall_vps | Bearer | service_id, os_id (int), confirm | Borra y reinstala con la imagen de SO dada — todos los datos se pierden. El aprovisionamiento es asíncrono; consulta get_vps_status. |
cancel_service | Bearer | service_id, type? = end_of_period | immediate, confirm? | Por defecto end_of_period: permanece activo hasta que acaba el período pagado, luego no se renueva — sin pérdida de datos. immediate destruye la VM y todos los datos ahora (requiere confirm = nombre de host); el tiempo pagado no usado se reembolsa a tu saldo (refund_amount). |
Ejemplo: pedir y arrancar un VPS
list_plans() // elige product "nano", anota un os_id
register_account({ first_name, last_name, email }) // → token Bearer
topup_balance({ amount: 10 }) // paga la checkout_url devuelta en USDC/USDT
order_vps({ product: "nano", os_id: <os_id de list_plans>, ssh_key: "ssh-ed25519 AAAA..." })
get_vps_status({ service_id: <tu-service-id> }) // consulta → active, lee host/puerto/command SSH
power_vps({ service_id: <tu-service-id>, action: "reboot" })
Notas para agentes
- Envía
Authorization: Bearer <token>en cada llamada no pública. - Paga en USDC/USDT (Base, Ethereum, Polygon) — sin necesidad de tarjeta. Prefiere un saldo prepago para que pedir sea una llamada.
- Usa siempre
get_vps_statuspara leer los detalles de acceso; tratareinstall_vps,reset_passwordycancel_serviceinmediato como irreversibles.
¿Nuevo en la configuración? Empieza con la guía de conexión, o lee la documentación para la API REST subyacente.
Comentarios
Aún no hay comentarios. Sé el primero.