O servidor MCP da EQVPS expõe 16 ferramentas que deixam um agente de IA descobrir planos, abrir uma conta, pagar com cripto e operar totalmente um VPS. Endpoint: https://mcp.eqvps.com/mcp (Streamable HTTP). Veja o guia de conexão para conectá-lo ao seu cliente.
Modelo de autenticação: list_plans, register_account e login são públicas. Toda outra ferramenta exige um token Bearer — obtenha um na hora de register_account e envie-o como Authorization: Bearer <token>.
Descoberta e autenticação
| Ferramenta | Autenticação | Parâmetros | O que faz |
|---|---|---|---|
list_plans | pública | — | Lista todos os planos de VPS: preços, specs e as imagens de SO que cada plano pode inicializar. Chame isto primeiro para escolher um slug de product e um os_id. |
register_account | pública | first_name, last_name, email | Cria uma conta sem senha e sem etapa humana. Retorna um token Bearer. |
login | pública | email, password | Faz login com e-mail + senha; retorna um token Bearer. |
whoami | Bearer | — | Retorna o perfil da conta autenticada (id, nome, e-mail). Verifica o token. |
Saldo e pedidos
| Ferramenta | Autenticação | Parâmetros | O que faz |
|---|---|---|---|
get_balance | Bearer | — | Retorna o saldo de crédito pré-pago e a moeda. order_vps gasta dele automaticamente. |
topup_balance | Bearer | amount (USD, positivo) | Cria uma fatura de recarga; retorna uma checkout_url do PayRam. O saldo é creditado assim que o pagamento on-chain em USDC/USDT confirma. Uma recarga não paga por vez. |
order_vps | Bearer | product (slug do plano), os_id (int), hostname?, ssh_key? | Pede um VPS. Passe uma ssh_key (chave pública) para login root baseado em chave. Paga do saldo quando suficiente, caso contrário retorna uma fatura para pagar. |
pay_invoice | Bearer | invoice_id (int) | Inicia o pagamento de uma fatura própria não paga. Retorna uma checkout_url do PayRam; o VPS provisiona automaticamente assim que o pagamento confirma. |
Operando um VPS
| Ferramenta | Autenticação | Parâmetros | O que faz |
|---|---|---|---|
list_vps | Bearer | — | Lista os serviços de VPS da conta (id, status, plano). Use id como service_id abaixo. |
get_vps_status | Bearer | service_id (int) | Detalhe completo: status, specs, estado/uptime ao vivo da VM e acesso SSH (host, porta, command pronto para colar). Na primeira chamada de um servidor sem chave, retorna a password root de uso único. Consulte após order_vps até active. |
power_vps | Bearer | service_id, action = start | stop | reboot | Controle de energia do VPS. |
set_hostname | Bearer | service_id, hostname | Define o hostname do VPS (rótulo DNS válido; aplicado no próximo reboot/rebuild). |
get_vps_metrics | Bearer | service_id, timeframe? = hour | day | week | month | Métricas de série temporal de CPU, memória, rede e disco (padrão hour). |
Destrutivas — exigem confirm
Estas apagam dados ou acesso. confirm deve ser igual ao hostname exato (de get_vps_status) ou o literal DELETE. Confirme com o humano primeiro.
| Ferramenta | Autenticação | Parâmetros | O que faz |
|---|---|---|---|
reset_password | Bearer | service_id, confirm | Rotaciona a senha root. A senha ANTIGA para de funcionar imediatamente. A nova senha é lida uma vez via get_vps_status (também enviada por e-mail). |
reinstall_vps | Bearer | service_id, os_id (int), confirm | Apaga e reinstala com a imagem de SO dada — todos os dados são perdidos. O provisionamento é assíncrono; consulte get_vps_status. |
cancel_service | Bearer | service_id, type? = end_of_period | immediate, confirm? | Padrão end_of_period: permanece ativo até o fim do período pago, depois não é renovado — sem perda de dados. immediate destrói a VM e todos os dados agora (exige confirm = hostname); o tempo pago não usado é reembolsado no seu saldo (refund_amount). |
Exemplo: pedir e inicializar um VPS
list_plans() // escolha o product "nano", anote um os_id
register_account({ first_name, last_name, email }) // → token Bearer
topup_balance({ amount: 10 }) // pague a checkout_url retornada em USDC/USDT
order_vps({ product: "nano", os_id: <os_id de list_plans>, ssh_key: "ssh-ed25519 AAAA..." })
get_vps_status({ service_id: <seu-service-id> }) // consulte → active, leia host/porta/command SSH
power_vps({ service_id: <seu-service-id>, action: "reboot" })
Notas para agentes
- Envie
Authorization: Bearer <token>em toda chamada não pública. - Pague em USDC/USDT (Base, Ethereum, Polygon) — sem cartão. Prefira um saldo pré-pago para que pedir seja uma chamada.
- Sempre use
get_vps_statuspara ler os detalhes de acesso; tratereinstall_vps,reset_passworde ocancel_serviceimediato como irreversíveis.
Novo na configuração? Comece pelo guia de conexão, ou leia os Docs para a API REST subjacente.
Comentários
Nenhum comentário ainda. Seja o primeiro.