O servidor MCP da EQVPS (versão 1.6.0) tem 45 ferramentas para um token de cliente. Esta página cobre as 21 que alugam e operam um VPS: cada parâmetro, seu tipo e valor padrão, e no fim uma sequência de chamadas para copiar. Endpoint: https://mcp.eqvps.com/mcp (Streamable HTTP). Primeira vez? Comece pelo guia de conexão.
Última verificação em 2026-10-04 no servidor MCP 1.6.0 (tools/list).
De qual página você precisa? Os parâmetros das chamadas de VPS estão nesta página. Todas as ferramentas em uma lista, incluindo delegação, suporte, sandboxes e as 30 de revendedor, estão na lista completa. O que um token vazado pode fazer e como limitar um agente está em MCP guardrails.
Autenticação. list_plans, register_account e login são públicas. Todo o resto precisa de Authorization: Bearer <token>. Na mesma sessão MCP, o token fica guardado depois de register_account ou login.
service_id é o código do serviço vindo de order_vps ou list_vps, por exemplo 68J67T5. Um id numérico também funciona.
Conta e token
| Tool | Auth | Parameters | What it does |
|---|---|---|---|
list_plans | public | — | Planos com preços, especificações e as imagens de SO que cada um inicia. plans[] traz o plan_id mensal e anual. Chame primeiro. |
register_account | public | first_name, last_name, email, token_ttl_days? (1–1825, padrão 365) | Cria uma conta sem senha e devolve um token Bearer reutilizável com token_expires_at. Chame uma vez: uma segunda chamada cria uma segunda conta, vazia. |
login | public | email, password, token_ttl_days? | Devolve um token novo. Só funciona depois de set_password. |
refresh_token | Bearer | expires_in_days? (1–1825) | Emite um token novo e revoga o atual na hora. Um token expirado não pode ser renovado. |
set_password | Bearer | password (8+ caracteres, letras e números) | Ativa o login por email e senha como reserva se o token for perdido. Funciona uma vez; uma segunda chamada devolve 409. |
whoami | Bearer | — | id, nome e email da conta. Serve para verificar o token. |
Saldo e pedido
| Tool | Auth | Parameters | What it does |
|---|---|---|---|
get_balance | Bearer | — | Saldo pré-pago e moeda. order_vps paga a partir dele. |
topup_balance | Bearer | amount (USD) | Cria uma recarga em cripto e devolve uma checkout_url. O saldo é creditado quando o pagamento é confirmado on-chain. Só uma recarga não paga por vez. |
order_vps | Bearer | product, os_id, hostname?, ssh_key?, period? (month | year), plan_id?, location? (de | fi) | Pede um VPS e paga com o saldo quando ele cobre o preço; caso contrário, devolve uma fatura. Sem location, nós escolhemos. Um local sem capacidade livre devolve 409 location_unavailable com uma lista available, e nada é cobrado. Planos Windows ignoram ssh_key. |
pay_invoice | Bearer | invoice_id | Devolve uma checkout_url para uma fatura em aberto. O VPS é criado depois do pagamento. |
Operar um VPS
| Tool | Auth | Parameters | What it does |
|---|---|---|---|
list_vps | Bearer | — | Serviços ativos, em criação e suspensos. Os excluídos não aparecem. |
get_vps_status | Bearer | service_id, reveal? | Status, especificações, estado ao vivo e acesso: host, porta e um command pronto (SSH para Linux, RDP para Windows). reveal: true devolve a senha de root de uso único após o boot; password_pending: true significa: chame de novo em 30–60 s. |
power_vps | Bearer | service_id, action (start | stop | reboot) | Controle de energia. |
set_hostname | Bearer | service_id, hostname | Aplicado dentro do servidor em execução pelo guest agent. No Windows passa a valer após reiniciar (reboot_required: true). Se o servidor estiver desligado, devolve 409 agent_unavailable. |
get_vps_metrics | Bearer | service_id, timeframe? (hour | day | week | month, padrão hour) | CPU, memória, rede e disco ao longo do tempo. |
Troca de plano e cancelamento
| Tool | Auth | Parameters | What it does |
|---|---|---|---|
get_upgrade_options | Bearer | service_id | Planos para os quais este VPS pode mudar mantendo os dados: um plano maior, NAT para IPv4 dedicado ou dedicado para NAT. Cada opção mostra prorated_topup e mode. Um disco não pode diminuir. |
change_plan | Bearer | service_id, target_plan (product_id), confirm: true | Troca o plano no lugar, com um reboot de cerca de um minuto. A diferença proporcional é cobrada do saldo (402 se faltar); mudar para NAT reembolsa a diferença. |
cancel_service | Bearer | service_id, reason (3–500 caracteres, obrigatório), type? (end_of_period | immediate), confirm? | Padrão end_of_period: o servidor funciona até o fim do período pago e não é renovado. immediate destrói o servidor na hora, exige confirm igual ao hostname exato e devolve o tempo não usado ao saldo (refund_amount). |
undo_cancel | Bearer | service_id | Remove um cancelamento end_of_period agendado. Um cancelamento imediato não pode ser desfeito. |
Destrutivas: exigem confirm
confirm é o hostname exato de get_vps_status, ou DELETE. Pergunte à pessoa antes de chamar.
| Tool | Auth | Parameters | What it does |
|---|---|---|---|
reset_password | Bearer | service_id, confirm | Uma nova senha de root chega ao servidor em execução em 10–30 s e a antiga deixa de funcionar. Leia a nova uma vez com get_vps_status (reveal: true). Para senha perdida, não para um servidor que ainda está iniciando. |
reinstall_vps | Bearer | service_id, os_id, confirm | Apaga o disco e instala os_id. Todos os dados se perdem. Roda em segundo plano; consulte get_vps_status. |
Exemplo: do zero a um servidor rodando
list_plans() // pick a product slug and an os_id
register_account({ first_name: "Ada", last_name: "Agent", email: "you@yourdomain.com" }) // returns a token
topup_balance({ amount: 10 }) // pay the checkout_url in crypto
order_vps({ product: "nano", os_id: <os_id>, ssh_key: "ssh-ed25519 AAAA..." }) // returns a service_id
get_vps_status({ service_id: "<service_id>" }) // poll until active, then read access.command
power_vps({ service_id: "<service_id>", action: "reboot" })
cancel_service({ service_id: "<service_id>", reason: "project finished" }) // end_of_period; undo_cancel keeps it
Notas para agentes
- Envie
Authorization: Bearer <token>em todas as chamadas, menos nas três públicas. Com HTTP puro, salve o token em um arquivo: uma variável de shell não sobrevive entre comandos separados. - Leia os dados de acesso em
get_vps_statusem vez de adivinhar a porta. Planos NAT usam uma porta pessoal; planos com IPv4 dedicado usam 22 no Linux e 3389 no Windows. - Um servidor novo leva cerca de um minuto para iniciar. Continue consultando
get_vps_status; não chamereset_passwordsó porque o SSH não respondeu de imediato. topup_balanceepay_invoicedevolvem um link de pagamento, que uma pessoa ou uma carteira precisa pagar. Monero é uma recarga manual separada no painel: veja pagar com Monero.
As mesmas ações sem MCP estão na documentação da API REST.
Comentários
Nenhum comentário ainda. Seja o primeiro.