Документация API и MCP

Как оплатить

Крипта заранее не нужна — карта тоже работает. EQVPS принимает крипту напрямую (только email, без KYC), а прямо на оплате можно купить крипту картой, через Apple Pay или Google Pay. Вот как работает каждый способ.

Аккаунт и оплата

Всё после первого заказа — промокоды, продление, апгрейд.

MCP для AI-агентов

EQVPS предоставляет сервер Model Context Protocol (MCP), чтобы AI-агенты могли находить тарифы, заказывать VPS, платить с предоплаченного баланса и управлять серверами — автономно. Эндпоинт работает по Streamable HTTP (стандарт remote-MCP 2026).

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

Зарегистрируй аккаунт EQVPS, покажи планы, создай крипто-инвойс на пополнение на $20, и как только я подтвержу оплату — закажи 2 VPS с Ubuntu 24.04 и дай мне их SSH-доступ.

Подключите агента

Добавьте это в конфиг вашего MCP-клиента (Claude Desktop или любой remote-HTTP MCP-клиент):

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

Получите токен, вызвав register_account или login через сам MCP-сервер. Инструмент list_plans работает без токена (discovery).

Аутентификация

EQVPS использует Bearer-токены, но есть ДВА РАЗДЕЛЬНЫХ пути аутентификации, не путайте их. AI-агенты: вызывают register_account (или login) через этот API/MCP — агент сам передаёт свои данные и получает токен мгновенно, БЕЗ почты и БЕЗ OTP-кода. Шлите его как Authorization: Bearer <token>. Люди на eqvps.com входят по passwordless email-OTP коду — этот браузерный путь только для людей, агент им воспользоваться не может (не читает почту). Агент должен использовать register_account, а не email-OTP. list_plans токена не требует.

Инструменты MCP

15 инструментов, сгруппированы по назначению. Каждый соответствует REST-эндпоинту.

Пример сценария

Типичная сессия агента: найти, зарегистрироваться, пополнить, заказать, управлять.

// 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 } }

REST API

За каждым MCP-инструментом стоит REST-эндпоинт, который можно вызвать напрямую. Базовый URL: https://api.eqvps.com

GET  /api/v1/eqvps/products
POST /api/v1/eqvps/auth/register
POST /api/v1/eqvps/auth/login
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

Аутентифицированные эндпоинты требуют Authorization: Bearer <token>.