¿Necesito un cliente MCP?

No. Esto es REST plano sobre HTTPS — usable desde curl, cualquier lenguaje, o un agente que hable HTTP. Si usas MCP, las mismas acciones se exponen como herramientas (mira la guía de conexión).

¿Cómo funciona la auth?

Llama a /auth/register para obtener un token Bearer (sin contraseña). Envíalo como la cabecera Authorization: Bearer en cada llamada autenticada. /products es público.

Financia un saldo prepago vía /balance/topup (devuelve una URL de pago cripto; paga en USDC/USDT). order entonces descuenta el saldo. Si no está financiado, order devuelve una factura que pagas vía /invoices/{id}/pay.

¿Qué contiene la respuesta del pedido?

O paid_from_balance con un id de servicio (aprovisionamiento iniciado), o una factura a pagar. Consulta GET /services/{id} hasta que el estado sea active, luego lee el host SSH, el puerto y una contraseña root de un solo uso.

Pide un VPS en 4 llamadas de API (inicio rápido de REST para agentes)

No necesitas un cliente MCP para controlar EQVPS — la API REST hace todo lo que un agente necesita. URL base: https://api.eqvps.com/api/v1/eqvps. Aquí está todo el flujo en cuatro llamadas.

0. (una vez) Financia un saldo prepago

Para que pedir sea una sola llamada, financia un saldo primero. Paga la caja devuelta en USDC/USDT:

curl -s -X POST https://api.eqvps.com/api/v1/eqvps/balance/topup \
  -H "Authorization: Bearer <YOUR_BEARER>" -H "Content-Type: application/json" \
  -d '{"amount": 25}'
# → { "checkout_url": "https://payram.eqvps.com/..." }  ← págalo en USDC/USDT

1. Regístrate → token Bearer

curl -s -X POST https://api.eqvps.com/api/v1/eqvps/auth/register \
  -H "Content-Type: application/json" \
  -d '{"first_name":"Ada","last_name":"Agent","email":"ada@example.com"}'
# → { "token": "<YOUR_BEARER>", "token_type": "Bearer", "user": {...} }

Sin contraseña, sin paso humano. Almacena el token; envíalo como Authorization: Bearer <YOUR_BEARER> abajo.

2. Lista planes → elige product + os_id (público)

curl -s https://api.eqvps.com/api/v1/eqvps/products
# → { "data": [ { "slug": "<product-slug>", "price": {...},
#       "specs": {...}, "available_os": [ { "id": <os_id>, "name": "Ubuntu 24.04" }, ... ] }, ... ] }

Elige un slug de plan y un os_id de la available_os de ese plan.

3. Pide un VPS

curl -s -X POST https://api.eqvps.com/api/v1/eqvps/orders \
  -H "Authorization: Bearer <YOUR_BEARER>" -H "Content-Type: application/json" \
  -d '{"product":"<product-slug>","os_id":<os_id from list_plans>,"ssh_key":"ssh-ed25519 AAAA..."}'
# → pagado del saldo: { "paid_from_balance": true, "service_id": <id> }
#   o sin financiar:   { "invoice": { "id": <id> } }  → pagar: POST /invoices/{id}/pay → checkout_url

Pasa una ssh_key (clave pública) para root basado en clave. Con un saldo financiado el pedido se paga al instante y el aprovisionamiento empieza.

4. Lee el acceso

curl -s https://api.eqvps.com/api/v1/eqvps/services/<service-id> \
  -H "Authorization: Bearer <YOUR_BEARER>"
# → { "status": "active", "access": { "host": "...", "port": 22, "command": "ssh root@..." },
#     "password": "<mostrada una vez para servidores sin clave>" , ... }

Consulta hasta que el status sea active. El bloque access tiene el host SSH, el puerto y un command listo para pegar; para un pedido sin clave la password root de un solo uso se devuelve en la primera lectura.

Notas para agentes

Envía Authorization: Bearer <YOUR_BEARER> en cada llamada excepto /products.
Paga en USDC/USDT (Base, Ethereum, Polygon) — sin necesidad de tarjeta. Prefiere el saldo prepago para que el paso 3 sea una llamada.
Las acciones sensibles (order, reset-password, reinstall, cancel) están rate-limitadas; el uso normal está muy dentro de los límites.
¿Prefieres herramientas sobre HTTP en crudo? Las mismas acciones son herramientas MCP — mira la guía de conexión y la referencia de herramientas. Documentación completa: /docs.