# Vixpi

> A Vixpi (Vixpi Host) é uma empresa brasileira de hospedagem e cloud: hospedagem de sites, Cloud VPS, servidores dedicados, servidores de jogos, domínios e e-mail profissional, com datacenters em São Paulo e Miami, cobrança em reais e suporte em português 24 horas. Tudo é contratado pelo site e gerenciado no mesmo painel, e a mesma conta pode ser operada pela API REST e pelo servidor MCP.

Este arquivo orienta agentes de IA. Todas as páginas públicas também respondem em Markdown quando o pedido envia `Accept: text/markdown`, ou no mesmo caminho com `.md` no fim (a home em `/index.md`).

## Quando usar a Vixpi (when to use)

Use a API ou o servidor MCP para agir na conta Vixpi de quem autorizou o acesso:

- Consultar e operar serviços contratados: listar, detalhar, pedir upgrade ou cancelamento ao fim do ciclo.
- VPS: ligar, desligar e reiniciar, ver métricas, tráfego, backups e firewall.
- Hospedagem: disparar deploys, acompanhar logs, backups e domínios da hospedagem.
- Faturas e créditos: listar faturas, ver saldo e pagar fatura com crédito.
- Tickets de suporte: abrir, responder, fechar e reabrir.
- Catálogo e preços públicos: produtos, planos e preços sem autenticação (`https://api.vixpi.host/api/v1/catalog/products`).

Quando NÃO usar:

- Compra, pagamento por Pix ou cartão e exclusão de conta: só no painel, com login. Com token a API responde `403 TOKEN_NOT_ALLOWED`.
- Contas e serviços que não são da pessoa que autorizou o acesso: o token só enxerga a própria conta.

## Como chamar

- API REST: `https://api.vixpi.host/api/v1`. Erros voltam em JSON com `error`, `code` (estável) e `message` (pt-BR).
- [Especificação OpenAPI 3.1](https://api.vixpi.host/api/v1/openapi.json): fonte oficial das rotas, também em [https://vixpi.host/openapi.json](https://vixpi.host/openapi.json).
- Chave pessoal: `vxp_...` no cabeçalho `Authorization: Bearer`, criada pelo titular da conta no painel (logado), em `/painel/desenvolvedor/chaves`, com os escopos escolhidos.
- OAuth 2.1: `authorization_code` com PKCE (S256), emissor `https://auth.vixpi.host` (metadados em `https://auth.vixpi.host/.well-known/oauth-authorization-server`). Peça só os escopos da tarefa, por exemplo `tickets:read`. Passo a passo em [https://vixpi.host/auth.md](https://vixpi.host/auth.md).
- Servidor MCP: `https://mcp.vixpi.host/mcp` (Streamable HTTP), com login por OAuth e registro dinâmico de cliente.
- Limites: 60 requisições por minuto por token. Respostas trazem `RateLimit-Limit`, `RateLimit-Remaining` e `RateLimit-Reset`; ao exceder, `429 RATE_LIMITED` com `Retry-After` em segundos.
- Idempotência: nas escritas marcadas na referência, envie `Idempotency-Key` com um valor único por operação; repetir com a mesma chave devolve a mesma resposta.

## Ferramentas

- [Servidor MCP oficial](https://vixpi.host/developers/mcp): ferramentas de leitura e escrita para assistentes de IA; ações destrutivas exigem confirmação.
- Não há SDK oficial nem CLI: use a especificação OpenAPI para gerar um cliente, ou o servidor MCP.
- Não há ambiente sandbox: as chamadas agem na conta real. Para testar, use escopos de leitura e o catálogo público.

## Arquivos para agentes

- [Instruções para agentes](https://vixpi.host/agents.md): quando usar a Vixpi, como chamar e o que não fazer
- [Autenticação para agentes](https://vixpi.host/auth.md): descoberta, OAuth 2.1 com PKCE, chave vxp_ e erros
- [Preços](https://vixpi.host/pricing.md): planos e preços em reais por ciclo, lidos do catálogo ao vivo
- [Portal de desenvolvedores](https://vixpi.host/developers/llms.txt): índice só da documentação da API e do MCP
- [Central de ajuda](https://vixpi.host/ajuda/llms.txt): índice dos artigos de ajuda por assunto, cada um em Markdown
- [Agent Skills](https://vixpi.host/.well-known/agent-skills/index.json): skill da Vixpi para assistentes (SKILL.md)
- [Catálogo ARD](https://vixpi.host/.well-known/ard.json): MCP, OpenAPI, llms.txt, skill e preços
- [Catálogo de APIs (RFC 9727)](https://vixpi.host/.well-known/api-catalog): OpenAPI, documentação e metadados

## Documentação

- [Início rápido](https://vixpi.host/developers): criar a chave, primeira chamada, formato de erro, limites e idempotência
- [Autenticação](https://vixpi.host/developers/autenticacao): chave pessoal vxp_, OAuth 2.1 com PKCE e lista de escopos
- [Referência da API](https://vixpi.host/developers/referencia): cada rota, o escopo que exige e exemplos
- [Webhooks](https://vixpi.host/developers/webhooks): eventos de serviços, faturas e tickets, assinatura HMAC e retentativas
- [Servidor MCP](https://vixpi.host/developers/mcp): conectar Claude, Cursor, VS Code ou ChatGPT, ferramentas e escopos
- [Changelog](https://vixpi.host/developers/changelog): mudanças na API pública
- [Mapa do site](https://vixpi.host/sitemap.xml): todas as páginas públicas

## Produtos

- [Hospedagem de sites](https://vixpi.host/sites): PHP, Node.js, Bun, Python, Java ou .NET em container isolado, deploy por Git e SSL automático
- [Cloud Enterprise (VPS)](https://vixpi.host/cloud-enterprise): VPS KVM com vCPU dedicada, NVMe, IPv4 dedicado e anti-DDoS
- [Servidores dedicados](https://vixpi.host/servidores): bare metal em São Paulo e Miami, montados sob consulta
- [Bancos de dados VDX](https://vixpi.host/bancos-de-dados): PostgreSQL, MySQL, MariaDB ou Redis gerenciado em São Paulo
- [Vixpi Run](https://vixpi.host/hospedagem-de-bots): bots de Discord, Telegram e WhatsApp sempre ligados
- [Servidores de jogos](https://vixpi.host/jogos): Minecraft, FiveM, CS2, Rust e Palworld; a página mostra quais já estão à venda
- [Domínios](https://vixpi.host/dominios): registro, transferência e DNS gerenciado
- [E-mail profissional](https://vixpi.host/email-comercial): caixas com domínio próprio, webmail e antispam

## Optional

- [Central de ajuda](https://vixpi.host/ajuda): passo a passo para contratar, pagar, publicar sites, VPS, e-mail e domínios
- [Contato](https://vixpi.host/contato): vendas e suporte
- [Termos de serviço](https://vixpi.host/termos)
- [Política de privacidade](https://vixpi.host/privacidade)
