Preciso de um cliente MCP?

Não. Isto é REST puro por HTTPS — usável de curl, qualquer linguagem, ou um agente que fala HTTP. Se você usa MCP, as mesmas ações são expostas como ferramentas (veja o guia de conexão).

Como a autenticação funciona?

Chame /auth/register para obter um token Bearer (sem senha). Envie-o como o header Authorization: Bearer em toda chamada autenticada. /products é público.

Abasteça um saldo pré-pago via /balance/topup (retorna uma URL de checkout cripto; pague em USDC/USDT). order então debita o saldo. Se não abastecido, order retorna uma fatura que você paga via /invoices/{id}/pay.

O que a resposta do pedido contém?

Ou paid_from_balance com um id de serviço (provisionamento iniciado), ou uma fatura para pagar. Consulte GET /services/{id} até o status ser active, depois leia o host SSH, a porta e uma senha root de uso único.

Peça um VPS em 4 chamadas de API (guia rápido de REST para agentes)

Você não precisa de um cliente MCP para conduzir a EQVPS — a API REST faz tudo o que um agente precisa. URL base: https://api.eqvps.com/api/v1/eqvps. Eis o fluxo inteiro em quatro chamadas.

0. (uma vez) Abasteça um saldo pré-pago

Para que pedir seja uma única chamada, abasteça um saldo primeiro. Pague o checkout retornado em 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/..." }  ← pague em USDC/USDT

1. Cadastro → 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": {...} }

Sem senha, sem etapa humana. Guarde o token; envie-o como Authorization: Bearer <YOUR_BEARER> abaixo.

2. Liste os planos → escolha 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" }, ... ] }, ... ] }

Escolha um slug de plano e um os_id do available_os daquele plano.

3. Peça um 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 de list_plans>,"ssh_key":"ssh-ed25519 AAAA..."}'
# → pago do saldo: { "paid_from_balance": true, "service_id": <id> }
#   ou não abastecido: { "invoice": { "id": <id> } }  → pague: POST /invoices/{id}/pay → checkout_url

Passe uma ssh_key (chave pública) para login root baseado em chave. Com um saldo abastecido o pedido é pago na hora e o provisionamento começa.

4. Leia o acesso

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 uma vez para servidores sem chave>" , ... }

Consulte até o status ser active. O bloco access tem o host SSH, a porta e um command pronto para colar; para um pedido sem chave, a password root de uso único é retornada na primeira leitura.

Notas para agentes

Envie Authorization: Bearer <YOUR_BEARER> em toda chamada exceto /products.
Pague em USDC/USDT (Base, Ethereum, Polygon) — sem cartão. Prefira o saldo pré-pago para que o passo 3 seja uma chamada.
Ações sensíveis (order, reset-password, reinstall, cancel) têm limite de taxa; o uso normal fica bem dentro dos limites.
Prefere ferramentas em vez de HTTP puro? As mesmas ações são ferramentas MCP — veja o guia de conexão e a referência de ferramentas. Docs completos: /docs.