REST API · MCP

EQVPS API

ይመዘገቡ፣ በክሪፕቶ ይሞሉ እና VPS ሙሉ በኮድ ይዘዙ — KYC የለም፣ በዑደቱ ውስጥ ሰው የለም። ለገንቢዎች እና የራሳቸውን ሰርቨሮች ለሚያቀርቡ AI agents የተገነባ።

OpenAPI 3.1MCP live · 47 toolsBearer authREST + MCP

መሠረታዊ URLhttps://api.eqvps.com/api/v1/eqvps

ፈጣን መጀመሪያ

አራት calls: ከዜሮ ወደ የሚሠራ VPS። ከታች ያሉት tokens placeholders ናቸው — እውነተኛ token በገጽ ላይ በጭራሽ አይለጥፉ።

# 1. Register — returns a Bearer token (no KYC, no human step)
curl -X POST https://api.eqvps.com/api/v1/eqvps/auth/register \
  -H "Content-Type: application/json" \
  -d '{"first_name":"Ada","last_name":"Agent","email":"agent@example.com"}'
# → { "token": "<YOUR_API_TOKEN>" }

# 2. Top up balance — pay in USDC / USDT / PYUSD, get a checkout URL
curl -X POST https://api.eqvps.com/api/v1/eqvps/balance/topup \
  -H "Authorization: Bearer <YOUR_API_TOKEN>" \
  -H "Content-Type: application/json" \
  -d '{"amount":20}'
# → { "checkout_url": "https://…" }   # pay on-chain, balance credits automatically

# 3. Order a VPS — paid from balance (get slug + os_id from GET /products)
curl -X POST https://api.eqvps.com/api/v1/eqvps/orders \
  -H "Authorization: Bearer <YOUR_API_TOKEN>" \
  -H "Content-Type: application/json" \
  -d '{"product":"micro","os_id":1,"ssh_key":"ssh-ed25519 AAAA…"}'

# 4. Read SSH access — one-time root password is shown once here
curl https://api.eqvps.com/api/v1/eqvps/services/SV-XXXXXX \
  -H "Authorization: Bearer <YOUR_API_TOKEN>"
# → { "data": { "status":"active", "access": { "method":"ssh", "host":"…", "port":20123, "command":"ssh root@… -p 20123", "ssh_ready":true } } }

ቁልፍ endpoints

ዋናው ገጽታ። ለእያንዳንዱ parameter እና ምላሽ interactive explorer ይክፈቱ።

POST/auth/registerመለያ ይፍጠሩ እና Bearer token ያግኙ። የይለፍ ቃል የለም፣ የሰው እርምጃ የለም።

GET/productsሁሉንም VPS ዕቅዶች ከዝርዝሮች፣ ዋጋ እና ከሚደገፉ OS images ጋር ይዘርዝሩ።

POST/balance/topupየክሪፕቶ መሙያ ደረሰኝ ይፍጠሩ፤ checkout URL ይመልሳል። ቀሪ ሂሳብ በon-chain ማረጋገጫ ይሞላል።

POST/ordersVPS ይዘዙ። ከተሞላ ከቀሪ ሂሳብ ይከፍላል፣ አለበለዚያ ያልተከፈለ ደረሰኝ ይመልሳል።

GET/services/{id}ሙሉ ሁኔታ + ቀጥታ SSH መዳረሻ። የአንድ-ጊዜ root የይለፍ ቃል እዚህ አንድ ጊዜ ይታያል።

GET/balanceቅድመ-ክፍያ credit ቀሪ ሂሳብ እና ምንዛሪ።

ሁሉንም endpoint፣ parameter እና schema በ interactive explorer ውስጥ ይመልከቱ →

ለAI agents

አንድ agent በራሱ ከምንም ወደ የሚሠራ ሰርቨር መሄድ ይችላል — ማግኘት፣ መክፈል፣ provision ማድረግ እና SSH ማንበብ፣ ሁሉም በAPI ወይም MCP በኩል።

MCP ቀጥታ ነው — የታቀደ አይደለም።

ማንኛውንም MCP client ወደ https://mcp.eqvps.com/mcp (Streamable HTTP) ያመልክቱ። 47 tools discovery፣ መለያ፣ ክፍያ እና ሙሉ VPS ቁጥጥር ይሸፍናሉ። የሕዝብ tools: list_plans፣ register_account፣ login፤ ሌላው ሁሉ Bearer token ይፈልጋል።

ራስ-ገዝ ፍሰት

1. register_account → Bearer token ያግኙ
2. topup_balance → checkout URLን በUSDC/USDT ይክፈሉ
3. order_vps → ከቀሪ ሂሳብ provision ያድርጉ
4. get_vps_status → እስኪነቃ ድረስ ይመልከቱ፣ SSH ያንብቡ (host፣ port፣ ትዕዛዝ፣ የአንድ-ጊዜ የይለፍ ቃል)

ማሽን-ተነባቢ ሀብቶች

agent.jsonየማሽን መገለጫ — እቅዶች፣ endpoints፣ የMCP ሁኔታ።mcp.jsonየMCP ማኒፌስት — የሰርቨር URL እና የመሣሪያ ዝርዝር።llms.txtአጭር የLLM መመሪያ ከጫፍ-እስከ-ጫፍ ምሳሌ ጋር።llms-full.txtየተስፋፋ የLLM ማጣቀሻ።openapi.jsonOpenAPI 3.1 ዝርዝር (explorerን ያንቀሳቅሳል)።

ለAI ወኪሎች የኮድ ሳንድቦክሶች

በአንድ ሰከንድ ገደማ የሚነሱ እና ለወኪሎችዎ Python፣ Node.js እና shell የሚያስኪዱ የተገለሉ Linux microVMዎች። ከዚያው የክሪፕቶ ሂሳብ በሰከንድ ይከፈላል፣ በሰዓት ከ$0.0165 ጀምሮ። በSDK፣ MCP ወይም REST ያስጀምሯቸው።

pip install eqvps          # Python
npm i @eqvps/sdk           # TypeScript / JavaScript
# MCP: create_sandbox -> run_code / exec_command -> kill_sandbox

ሳንድቦክሶችን ይሞክሩ — $1 በነፃ →የሳንድቦክስ ሰነዶች እና SDK →

ስህተቶች

መደበኛ HTTP status codes። Bodies በውድቀት ጊዜ message field ይይዛሉ።

ሁኔታትርጉም

200 / 201OK — request succeeded / resource created.

401Missing or invalid Bearer token.

403Authenticated, but not the owner of this resource.

404Resource not found.

409State conflict (e.g. an unpaid top-up already exists).

422Validation error — check the request body.

429Rate limited — back off and retry.

Rate limits

ስሜታዊ ተግባራት (ማዘዝ፣ መሙላት፣ የይለፍ ቃል reset፣ እንደገና መጫን፣ console) በመለያ rate-limited ናቸው። መደበኛ automation ከገደቦች ውስጥ በደንብ ይቆያል፤ በ429 ላይ፣ ቀንሰው እንደገና ይሞክሩ።

አሁን በእሱ ላይ ይገንቡ

specን ያግኙ፣ explorerን ይክፈቱ፣ ወይም ሙሉ ተራኪ ማጣቀሻ ከMCP setup ጋር ያንብቡ።

explorer ይክፈቱ docs ያንብቡ