REST API · MCP

API de EQVPS

Regístrate, recarga con cripto y pide un VPS de forma totalmente programática — sin KYC, sin humano en el bucle. Diseñada para desarrolladores y agentes de IA que aprovisionan sus propios servidores.

OpenAPI 3.1MCP live · 45 toolsBearer authREST + MCP

URL basehttps://api.eqvps.com/api/v1/eqvps

Probar en vivo Especificación OpenAPI Referencia completa

Inicio rápido

Cuatro llamadas: de cero a un VPS en marcha. Los tokens de abajo son ejemplos — nunca pegues un token real en una página.

# 1. Regístrate — devuelve un token Bearer (sin KYC, sin paso humano)
curl -X POST https://api.eqvps.com/api/v1/eqvps/auth/register \
  -H "Content-Type: application/json" \
  -d '{"first_name":"Ada","last_name":"Agent","email":"agent@example.com"}'
# → { "token": "<YOUR_API_TOKEN>" }

# 2. Recarga el saldo — paga en USDC / USDT / PYUSD, obtén una URL de pago
curl -X POST https://api.eqvps.com/api/v1/eqvps/balance/topup \
  -H "Authorization: Bearer <YOUR_API_TOKEN>" \
  -H "Content-Type: application/json" \
  -d '{"amount":20}'
# → { "checkout_url": "https://…" }   # paga on-chain, el saldo se acredita automáticamente

# 3. Pide un VPS — pagado del saldo (obtén slug + os_id de GET /products)
curl -X POST https://api.eqvps.com/api/v1/eqvps/orders \
  -H "Authorization: Bearer <YOUR_API_TOKEN>" \
  -H "Content-Type: application/json" \
  -d '{"product":"micro","os_id":1,"ssh_key":"ssh-ed25519 AAAA…"}'

# 4. Lee el acceso SSH — la contraseña root de un solo uso se muestra aquí una vez
curl https://api.eqvps.com/api/v1/eqvps/services/SV-XXXXXX \
  -H "Authorization: Bearer <YOUR_API_TOKEN>"
# → { "status":"active", "ssh": { "host":"…", "port":22, "command":"ssh root@… -p 22" } }

Endpoints clave

La interfaz principal. Abre el explorador interactivo para cada parámetro y respuesta.

POST/auth/registerCrea una cuenta y obtén un token Bearer. Sin contraseña, sin paso humano.

GET/productsLista todos los planes VPS con especificaciones, precio e imágenes de SO admitidas.

POST/balance/topupCrea una factura de recarga con cripto; devuelve una URL de pago. El saldo se acredita al confirmarse on-chain.

POST/ordersPide un VPS. Pagado del saldo si está recargado, si no devuelve una factura sin pagar.

GET/services/{id}Estado completo + acceso SSH en vivo. La contraseña root de un solo uso aparece aquí una vez.

GET/balanceSaldo prepago y moneda.

Ve cada endpoint, parámetro y esquema en el explorador interactivo →

Para agentes de IA

Un agente puede pasar de la nada a un servidor en marcha por sí mismo — descubrir, pagar, aprovisionar y leer el SSH, todo mediante la API o MCP.

MCP está en vivo — no planeado.

Apunta cualquier cliente MCP a https://mcp.eqvps.com/mcp (Streamable HTTP). 45 herramientas cubren descubrimiento, cuenta, pago y control total del VPS. Herramientas públicas: list_plans, register_account, login; todo lo demás requiere un token Bearer.

Flujo autónomo

1. register_account → obtener un token Bearer
2. topup_balance → pagar la URL de pago en USDC/USDT
3. order_vps → aprovisionar desde el saldo
4. get_vps_status → consultar hasta el estado activo, leer el SSH (host, puerto, comando, contraseña de un solo uso)

Recursos legibles por máquina

agent.jsonPerfil de máquina — planes, endpoints, estado MCP.mcp.jsonManifiesto MCP — URL del servidor y lista de herramientas.llms.txtGuía LLM concisa con un ejemplo de principio a fin.llms-full.txtReferencia LLM ampliada.openapi.jsonEspecificación OpenAPI 3.1 (impulsa el explorador).

Sandboxes de código para agentes de IA

MicroVM Linux aisladas que arrancan en un segundo aproximadamente y ejecutan Python, Node.js y shell para tus agentes. Se cobran por segundo del mismo saldo cripto, desde $0.0165 la hora. Arranque con el SDK, MCP o REST.

pip install eqvps          # Python
npm i @eqvps/sdk           # TypeScript / JavaScript
# MCP: create_sandbox -> run_code / exec_command -> kill_sandbox

Probar los sandboxes — $1 gratis →Docs de sandboxes y SDK →

Errores

Códigos de estado HTTP estándar. En caso de error, el cuerpo incluye un campo message.

EstadoSignificado

200 / 201OK — solicitud correcta / recurso creado.

401Falta el token Bearer o es inválido.

403Autenticado, pero no eres el propietario de este recurso.

404Recurso no encontrado.

409Conflicto de estado (p. ej. ya existe una recarga sin pagar).

422Error de validación — revisa el cuerpo de la solicitud.

429Límite de tasa — espera y reinténtalo.

Límites de tasa

Las acciones sensibles (pedido, recarga, restablecimiento de contraseña, reinstalación, consola) están limitadas por cuenta. La automatización normal se mantiene muy dentro de los límites; ante un 429, espera y reinténtalo.

Construye sobre ello ahora

Consigue la especificación, abre el explorador o lee la referencia completa con la configuración de MCP.

Abrir el explorador Leer la documentación