Documentação de API e MCP

Como pagar

Você não precisa já ter cripto — um cartão também funciona. O EQVPS aceita cripto diretamente (só um e-mail, sem KYC), e no próprio checkout você pode comprar a cripto com cartão, Apple Pay ou Google Pay. Veja como cada método funciona.

Conta e cobrança

Tudo após o primeiro pedido — códigos promocionais, renovação, upgrade.

MCP para agentes de IA

O EQVPS expõe um servidor Model Context Protocol (MCP) para que agentes de IA descubram planos, peçam um VPS, paguem de um saldo pré-pago e gerenciem servidores — de forma autônoma. O endpoint fala Streamable HTTP (o padrão de MCP remoto de 2026).

claude mcp add --transport http eqvps https://mcp.eqvps.com/mcp

Registre uma conta EQVPS, mostre-me os planos, crie uma fatura de recarga em cripto de US$20, e assim que eu confirmar o pagamento, peça 2 VPS Ubuntu 24.04 e me dê o acesso SSH deles.

Conecte seu agente

Adicione isto à configuração do seu cliente MCP (Claude Desktop ou qualquer cliente MCP remoto por HTTP):

{
  "mcpServers": {
    "eqvps": {
      "type": "streamable-http",
      "url": "https://mcp.eqvps.com/mcp",
      "headers": { "Authorization": "Bearer <YOUR_TOKEN>" }
    }
  }
}

Obtenha um token chamando register_account ou login pelo próprio servidor MCP. A ferramenta list_plans funciona sem token (descoberta). Você também pode gerar um token em Configurações da conta → Tokens de API para agentes.

Autenticação

O EQVPS usa tokens Bearer — mas há dois caminhos de autenticação SEPARADOS, não os misture. Agentes de IA: chame register_account (ou login) por esta API/MCP — o agente fornece suas próprias credenciais e recebe um token na hora, SEM e-mail e SEM código OTP. Envie-o como Authorization: Bearer <token>. Humanos no eqvps.com entram com um código OTP por e-mail sem senha — esse fluxo de navegador é só para pessoas e um agente não pode usá-lo (não consegue ler e-mail). Um agente deve usar register_account, nunca o fluxo de e-mail-OTP. list_plans não precisa de token.

Ferramentas MCP

15 ferramentas, agrupadas por finalidade. Cada uma mapeia para um endpoint REST.

Fluxo de exemplo

Uma sessão típica de agente: descobrir, registrar, financiar, pedir, gerenciar.

// 1. Discover plans (no auth)
list_plans()
// 2. Create an account → get token
register_account({ name, email, password }) → { token }
// 3. (human or agent) fund the balance with crypto
topup_balance({ amount: 25 }) → { checkout_url }   // pay the URL
// 4. Order a VPS — paid from balance, provisioning starts
order_vps({ product: "micro", os_id: 1, ssh_key })
   → { paid_from_balance: true, service_id }
// 5. Poll until ready, then read SSH access
get_vps_status({ id: service_id }) → { status: "active", access: { command } }

API REST

Cada ferramenta MCP é apoiada por um endpoint REST que você pode chamar diretamente. URL base: https://api.eqvps.com

GET  /api/v1/eqvps/products
POST /api/v1/eqvps/auth/register
POST /api/v1/eqvps/auth/login
POST /api/v1/eqvps/auth/otp/request
POST /api/v1/eqvps/auth/otp/verify
POST /api/v1/eqvps/auth/set-password
GET  /api/v1/eqvps/balance
POST /api/v1/eqvps/balance/topup
POST /api/v1/eqvps/orders
POST /api/v1/eqvps/invoices/{id}/pay
GET  /api/v1/eqvps/services
GET  /api/v1/eqvps/services/{id}
POST /api/v1/eqvps/services/{id}/power
POST /api/v1/eqvps/services/{id}/hostname
POST /api/v1/eqvps/services/{id}/reset-password
POST /api/v1/eqvps/services/{id}/reinstall
GET  /api/v1/eqvps/services/{id}/metrics

Endpoints autenticados exigem Authorization: Bearer <token>.