Dokumentacja API i MCP

Jak zapłacić

Nie musisz już posiadać krypto — karta też działa. EQVPS przyjmuje krypto bezpośrednio (wystarczy e-mail, bez KYC), a prosto przy kasie możesz kupić krypto kartą, przez Apple Pay lub Google Pay. Oto jak działa każda metoda.

Konto i rozliczenia

Wszystko po pierwszym zamówieniu — kody promocyjne, odnawianie, ulepszanie.

MCP dla agentów AI

EQVPS udostępnia serwer Model Context Protocol (MCP), aby agenci AI mogli odkrywać plany, zamawiać VPS, płacić z przedpłaconego salda i zarządzać serwerami — autonomicznie. Punkt końcowy mówi w Streamable HTTP (standard zdalnego MCP z 2026 roku).

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

Zarejestruj konto EQVPS, pokaż mi plany, utwórz fakturę doładowania krypto na 20 $, a następnie, gdy potwierdzę płatność, zamów 2 VPS Ubuntu 24.04 i podaj mi ich dostęp SSH.

Podłącz swojego agenta

Dodaj to do konfiguracji swojego klienta MCP (Claude Desktop lub dowolnego zdalnego klienta MCP przez HTTP):

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

Uzyskaj token, wywołując register_account lub logując się przez sam serwer MCP. Narzędzie list_plans działa bez tokenu (odkrywanie). Możesz też wygenerować token w Ustawieniach konta → Tokeny API dla agentów.

Uwierzytelnianie

EQVPS używa tokenów Bearer — ale są dwie ODDZIELNE ścieżki uwierzytelniania, nie mieszaj ich. Agenci AI: wywołaj register_account (lub login) przez to API/MCP — agent podaje własne dane uwierzytelniające i natychmiast otrzymuje token, BEZ e-maila i BEZ kodu OTP. Wyślij go jako Authorization: Bearer <token>. Ludzie na eqvps.com logują się bezhasłowym kodem OTP z e-maila — ten przepływ w przeglądarce jest tylko dla ludzi i agent nie może go użyć (nie może czytać e-maila). Agent musi używać register_account, nigdy przepływu e-mail-OTP. list_plans nie wymaga tokenu.

Narzędzia MCP

15 narzędzi, pogrupowanych według celu. Każde odpowiada punktowi końcowemu REST.

Przykładowy przepływ

Typowa sesja agenta: odkryj, zarejestruj, zasil, zamów, zarządzaj.

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

Każde narzędzie MCP jest oparte na punkcie końcowym REST, który możesz wywołać bezpośrednio. Bazowy URL: 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

Uwierzytelnione punkty końcowe wymagają Authorization: Bearer <token>.