আমার কি একটি MCP client দরকার?

না। এটি HTTPS-এর ওপর সাধারণ REST — curl, যেকোনো ভাষা, বা HTTP বলা একটি agent থেকে ব্যবহারযোগ্য। আপনি MCP ব্যবহার করলে, একই action tools হিসেবে উন্মুক্ত (connect গাইড দেখুন)।

Auth কীভাবে কাজ করে?

একটি Bearer token পেতে /auth/register ডাকুন (কোনো password নয়)। প্রতিটি authenticated call-এ এটি Authorization: Bearer header হিসেবে পাঠান। /products পাবলিক।

কীভাবে পরিশোধ করি?

/balance/topup-র মাধ্যমে একটি prepaid balance funded করুন (একটি ক্রিপ্টো checkout URL ফেরত দেয়; USDC/USDT-তে পরিশোধ করুন)। order তখন balance debit করে। unfunded হলে, order একটি invoice ফেরত দেয় যা আপনি /invoices/{id}/pay-র মাধ্যমে পরিশোধ করেন।

order প্রতিক্রিয়ায় কী থাকে?

হয় একটি service id সহ paid_from_balance (provision শুরু হয়েছে), বা পরিশোধের জন্য একটি invoice। status active না-হওয়া পর্যন্ত GET /services/{id} poll করুন, তারপর SSH host, port, ও একটি এককালীন root password পড়ুন।

4টি API call-এ একটি VPS অর্ডার করুন (agent-দের জন্য REST quickstart)

EQVPS চালাতে আপনার একটি MCP client লাগে না — REST API একটি agent-এর যা দরকার সব করে। Base URL: https://api.eqvps.com/api/v1/eqvps। এই যে চারটি call-এ পুরো flow।

0. (একবার) একটি prepaid balance funded করুন

যাতে অর্ডার একটি একক call হয়, আগে একটি balance funded করুন। ফেরত-পাওয়া checkout USDC/USDT-তে পরিশোধ করুন:

curl -s -X POST https://api.eqvps.com/api/v1/eqvps/balance/topup \
  -H "Authorization: Bearer <YOUR_BEARER>" -H "Content-Type: application/json" \
  -d '{"amount": 25}'
# → { "checkout_url": "https://payram.eqvps.com/..." }  ← USDC/USDT-তে পরিশোধ করুন

1. Register → Bearer token

curl -s -X POST https://api.eqvps.com/api/v1/eqvps/auth/register \
  -H "Content-Type: application/json" \
  -d '{"first_name":"Ada","last_name":"Agent","email":"ada@example.com"}'
# → { "token": "<YOUR_BEARER>", "token_type": "Bearer", "user": {...} }

কোনো password নয়, মানব-ধাপ নয়। token সংরক্ষণ করুন; নিচে এটি Authorization: Bearer <YOUR_BEARER> হিসেবে পাঠান।

2. প্ল্যান তালিকাভুক্ত → product + os_id বাছুন (পাবলিক)

curl -s https://api.eqvps.com/api/v1/eqvps/products
# → { "data": [ { "slug": "<product-slug>", "price": {...},
#       "specs": {...}, "available_os": [ { "id": <os_id>, "name": "Ubuntu 24.04" }, ... ] }, ... ] }

একটি প্ল্যান slug ও সেই প্ল্যানের available_os থেকে একটি os_id বাছুন।

3. একটি VPS অর্ডার করুন

curl -s -X POST https://api.eqvps.com/api/v1/eqvps/orders \
  -H "Authorization: Bearer <YOUR_BEARER>" -H "Content-Type: application/json" \
  -d '{"product":"<product-slug>","os_id":<list_plans থেকে os_id>,"ssh_key":"ssh-ed25519 AAAA..."}'
# → balance থেকে পরিশোধিত: { "paid_from_balance": true, "service_id": <id> }
#   বা unfunded:       { "invoice": { "id": <id> } }  → পরিশোধ: POST /invoices/{id}/pay → checkout_url

key-ভিত্তিক root login-এর জন্য একটি ssh_key (public key) পাস করুন। একটি funded balance সহ অর্ডার তাৎক্ষণিক পরিশোধিত হয় ও provision শুরু হয়।

4. Access পড়ুন

curl -s https://api.eqvps.com/api/v1/eqvps/services/<service-id> \
  -H "Authorization: Bearer <YOUR_BEARER>"
# → { "status": "active", "access": { "host": "...", "port": 22, "command": "ssh root@..." },
#     "password": "<keyless সার্ভারের জন্য একবার দেখানো>" , ... }

status active না-হওয়া পর্যন্ত poll করুন। access block-এ SSH host, port, ও একটি ready-to-paste command আছে; একটি keyless অর্ডারের জন্য এককালীন root password প্রথম read-এ ফেরত দেওয়া হয়।

agent-দের জন্য নোট

/products ছাড়া প্রতিটি call-এ Authorization: Bearer <YOUR_BEARER> পাঠান।
USDC/USDT-তে পরিশোধ করুন (Base, Ethereum, Tron) — কোনো কার্ড লাগে না। prepaid balance পছন্দ করুন যাতে ধাপ 3 একটি call।
সংবেদনশীল action (order, reset-password, reinstall, cancel) rate-limited; স্বাভাবিক ব্যবহার সীমার ভালোই ভেতরে।
raw HTTP-র চেয়ে tools পছন্দ? একই action MCP tools — connect গাইড ও tools রেফারেন্স দেখুন। সম্পূর্ণ ডকুমেন্টেশন: /docs।